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Technical consultation is available for any problems you 
“‘“neounter in verifying the proper operation of these 
products. Sorry, but we are not able to evaluate or 
assist in the debugging of any programs you may develop. ~~ 
For technical assistance, call: | 


(616) 982-3884 Application Software 
(616) 982-3860 Onerating System/Language Software 


Consultation is available from 8:00 AM to 12:00 PM and ! 
1:00 PM to 4:30 PM (EST) on normal business days. | 


Zenith Data Systems 
Software Consultation 

Hilltop Road 

St. Joseph, Hichigan 89085 
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“INTRODUCTION - ‘TO -CP-/ M- 
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>... A general introduction ~ to: the: ‘CP/M operating 
[2 y system. a ee ee ee ee 

@ Ae ee bo dein manual opeenivaricn: 

© The. required hardware environment. 


© The bueis duepccences between CP/M Version 
2.2.92 and Version 2.2.03. 


In this Chapter you will find a brief introduction to and 
summary of the CP/M (Control Program for Microcomputers) 
Operating System designed by Digital Research. This release of 
CP/M has been supplemented by Zenith Data Systems, specifically 
to facilitate the use of Heath/Zenith hardware systems in a wide 
variety of both Business and Personal applications. 


.This chapter gives .a-brief.-summary of. the-basic organization of ------- 


the manuals that form the body of this work--the first one, 
written by Heath/Zenith, and those that follow, written by 
Digital Research. - 


version of CP/M supplied by Heath/Zenith is the standard 
Operating system. In all cases, software that is guaranteed to 
run under CP/M 2.2 should run on the Heath/Zenith 
implementation, provided that the media format is compatible and 
that there is adequate memory and mass-Storage capability. No 
Special input or output devices (e.g., graphics terminals, paper 
tape reader or punch, light pens, etc.) are required by this 
version. The Digital Research manual, “An Introduction to CP/M 
Features and Facilities," provides a more complete description 
of this product. 7 
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~~ The constant strides that have been made in hardware development - 
by Heath/Zenith, require constant software updates to keep 2 

abreast of the new developments. This manual is released with = 
Heath/Zenith CP/M Version 2.2.03 (the "2.2" being Digital 
Research's Version Number, and the " .03" being the Heath/Zenith 
implementation number). Version 2.2.03 has been released as an 
upgrade to Version 2.2.02 to support two additional types of 
disk drives, the 289-37 (Soft-Sectored, Disk System) and the Z67 
(Ten-Megabyte, Winchester Disk System), and to provide more 
flexibility in interfacing to different types of printers. 


NOTE: Throughout this manual an abbreviated 

notation has been used for all of the disk drives 

and disk drive cortrollers that are supported by 

this release of CP/M. Z37 is used both when 

discussing the 237 drives and the 289-37 drive 

controller; 267 is used for both the Winchester ) | 
System (Z67) and its interface (H/Z89-67):; H/Z47 is 
used also for the H/Z89-47 interface; and H/Z17 is | 
used for the H/Z89-17 controller, which is also 

used with the H/Z87 and HT77. | 


If this is your first exposure to CP/M, Chapters One through 
Five should be very useful to you. Their purpose is to 
| introduce the use of CP/M and in the process provide an 
ym overview of the use of the H/Z89 or the H8. isis 


Once you are familiar with the operation of CP/M, if you should Vy | 
wish to do some customization to suit a particular peripheral . 

~~-—-——device,-or-to-optimize the operating system's performance on 
your hardware configuration, chapters Five through Eight should 
be studied carefully. : 


preets 1a eeMeneetlinalibeste Regs i noe ebemdtee a see Meda teers Se te * 7 : ca et LE Mee af nr Mw. 8 


Aeeeoavetien » Ee. CP/H General Introduction 
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i peers ao Moar | 
Seer: ae as “Section One: General Introduction ae 
ev: ff pe. ee a 
‘A basic “operat ine system takes hardware-specific routines that 
all- programs. ‘necessarily have in common and arranges those 
routines in a way that a programmer or user may call on them 


when they are needed, The programmer/user does not need to 
write. each. instruction into the program each time it is 
required, A simplified definition of an operating system might 


be that-it allows the user to tell the computer "what" it should 
do without. needing to tell the computer "how" it is supposed to 


- - -~ . . 


do Ptw -- 


- 
“a - ° _ = 


The user. is freed from the burden of Reine: to understand the 
details. of. the underlying hardware and how it performs its 
functions. Some examples of this type of hardware-specific 
routine - might be: a method of accepting input from the user, a 
method of providing an output to the user, and a file management 
System that allows some type of data storage and retrieval. 


‘The CP/M operating system provides a common interface to a large 
variety of computer hardware. It does this by orchestrating the 
software's control and access of all system hardware. CP/M 
ye builds a standardized machine in software out of the available 
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hardware. This ability has facilitated the production of a wide > 


Ay ‘array of application software that can run under CP/M. This is 
because the software and hardware interaction is standardized by 


ww. CP/M, despite any physical differences that exist between the- 


various types of hardware that are available. 


A comprehensive file management scheme built into CP/M permits 


rapid access to programs and data stored on disk. Files are. 


allocated dynamically, and both sequential and random access is 

“permitted. CP/M also provides a level of independence for 
peripherals (terminal, printer, modem, etc.), permitting the 
Output of a program to be directed to different serial devices 
from the command level, 


This manual is designed to provide an introduction to the use of 
CP/M 2.2 on the Heath/Zenith equipment. This release of the 
industry standard operating system, CP/M, implements all of the 
‘basic features. As time goes on, Heath/Zenith will successively 
introduce revisions that include support for more hardware 
products and configurations, as well as general improvements in 
performance. 


~~ Version 2.2.03 of CP/M requires at least 32K of random access 

, memory in a Zenith Data Systems 289 or‘’a Heath H89 or a Heath 

ae H8. It supports up to six logical disk drives on the H/Z89 and 

| up to five disk drives on the H8& (Cat least one drive is 

oo. essential). Section Four on page 6, details the differences 

. between Heath/Zenith Version %.03" and the previously released 
version ",02", 


‘ 
| 
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Introduction to CP/M Manual Organization 


“ee 


Section Two: Manual Organization: 


The organization of this manual is based as much as possible. on 
a logical order for use of the CP/M utilities--those created by 
Digital Research and those created by Heath/Zenith. This manual 
begins with a brief description of the CP/M Operating System and 
the utilities that it provides the user. A basic description of 
the hardware configurations that are supported by this release 
is then covered, though most of the hardware configuration 
information is contained in the operating manuals that are 
provided when each item is’ purchased, Particular attention 
should be paid to the Hardware manuals for connection and 
configuration of the physical system. 


Directly after the Hardware description is a chapter ‘on 
beginning--how to boot the system, create backup copies of 


disks, and the general starting procedures. Next, the utility | 


programs written by or modified by Heath/Zenith are explained, 
with illustrations of how they may be used. Each of these 
utility programs will be covered step by step, wherever 
practical, within the text. Once these steps are learned CP/M 
will become an extremely easy-to-use tool. 


Following this manual and completing this set of manuals, are 


the manuals written by Digital Research. The Digital Research > 
““manuals provide additional understanding of the design and 


functions of CP/M. The section by Digital Research also 
contains manuals that are devoted to the complete explanation of 
the standard utilities found in CP/M. Finally, Digital Research 


-has included a basic alteration guide to explain those portions 


of the user-interface structure that may be customized so that 


the operating system is more suited to the ePerakens environment — 


and needs of the uSer, 


ee 


ee ee 


) 
J 


this version of CP/#. 
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Introduction to CP/H Hardware Awareness 


Section Three: Hardware Awareness 


The possible configurations for an operating environment expand 
as the available types of hardware increase. The intent of this 
manual is to describe the utilization of the operating system 
insofar as it coordinates all of the functions of the hardware 
in its particular configuration. It is also intended to make 
the user aware of the range of possible hardware configurations 
that CP/M is capable of orchestrating, and now it may best be 
implemented to do so, 


Tt is NOT the intention of this manual to replace the manuals 
that are provided with any computer or peripheral, nor to 
explain how to assemble and interconnect all of the various 
components that may be used; these details have been given 
specific and intensive coverage in the manual for each device. 


To cover those details here would make this manual difficult to. 


use, as well as cause the user to search through the many pages 
that would be necessary for the particular instructions 
applicable to the system that the user has assembled. 


For the actual installation and interconnection instructions for 
the various types of hardware, the user should consult the 
specific hardware manuals involved. Appendix B, on page 118, 
details what hardware configurations are necessary for a minimal 


“system, and what hardware is supported. It includes alist of © 


the physical components that are required by each one of those 
systems to provide a complete system that is supportable under 


eo Ge abies vEsces wo 
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—~ introduction ~to “CP/M | Version 2.2.02 Versus 2.2.03 


pect son pours wersion 2.2.02 Versus 2.2. 03 


AE ee ee Ts One: 


The main differences between these two Heath/Zenith 
implementations of CP/M are centered on the addition of programs 
to Support the 237 5.25-inch soft-sectored disk controller, and 
‘the. Z67 Winchester Disk System, CP/M has been enhanced to 
handle the additional input and Output operations that these 

y devices require, - New utilities have been added to make it 
easier. for the user to operate the system and achieve the 
desired results, — 


Additional input and output functions have been designed so that 
a wider variety of printers may be utilized with fewer 
modifications. . : 


One specific item of some note has changed that did not exist in 

the previous implementation, A label has been added in code to 

the data on the disks. The label has been created to allow CP/M 

to determine the media type and density of a disk when it reads 

the system tracks into memory. This label resides on Side 0, 
Track 0, Sector 1 of the disk. The label is written during 

oo FORMAT to ‘the Z37 and the 267 Winchester Disk (not to the 267 


floppy); and written to H/Z17, H/Z47 disks and 267 floppy disks (| 


when they are Sysgened. This method makes disks that have been 
created with previous releases of CP/M compatible and aliows the 


oa User. to use previously. generated disks that-do not have this ----->” 


label. This is, of course, more meaningful and useful to the 
experienced programmer who wants to make modific: -‘Cions, rather 
than to the general user or first-time initiate. : 


é 
eae 
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oan ene "The. Basics in ‘optimizing @ system. 


In: this chance? all of the "Tirst- things" will be covered, It 
éontaings everything that you will need to do "first- thing’ 


before anything else. Even if ‘you neve ickades experience ae 


proceeding further. 


The first thing you must do upon receipt of this CP/M Syecen. is 
to read the enclosed Digital Research license agreement. Then 


complete the End User License Agreement and return it to Zenith... 


Data Systens. The postal card should be completed and returned 
to Digital Research. 


The serial number on the system disk (or disk set, if you 
purchased CP/M on 5.25 media) is your license to use CP/M on a 
single computer, The registration card insures that you will 
receive information concerning updates and revisions to this 
software, 


ve 


wees ee ons 
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in The Beginning ee FE CO CO Disk Handling Procedure 


PET ean rene 


Section One: Disk Handling Procedures 


Disks are somewhat fragile and should be handled accordingly. 
There are a few common sense rules that should be followed. 
Some of these rules, only apply’ to floppy disks though the 
Winchester Disk should also be considered quite fragile even 
though it is. totally. enclosed... You'll know that the old cliche 
is true once a disk has been ruined by a careless act: it is far 
better safe, than sorry! o-. 2+ 0 : ne “aoe 


eo ae _ 
- SNe ee Be See OS 


Information-is stored-on.the-disk-magnetically, so keep magnets 

and magnetic objects away! The surface of the disk should 

remain, clean, do not touch. the recording surface of the disk, : 
and keep it. in its protective envelope when not in use. A 
portion of the disk is exposed through the aperature that the 
read/write head of the disk drive accesses the recording’ | 
Surface (see: Appendix E, figures E-4 and E-~5 to identify the 

Read/Write Head Aperature). The envelope protects the exposed 

portion of the recording surface of the disk. Store disks flat 

and in a cool place to avoid deforming the plastic. 


Keeping your disks clearly labeled is important in helping you ) 
quickly find a desired file. Always prepare the label before 

affixing it to the disk to keep your writing instrument from C3 
marring the disk. Sar 


_.. Write Protection _.____ nny 


| 

You can "write-protect" a 5,.25-inch disk by putting one of the | 

Special foil tabs (these usually come with newly purchased | 
disks) over the notch in the side of the disk. _ Don't use 

cellophane or other types of tape! Tape can get adhesive on the | 

~--disk's recording surface. An 88-inch disk can be write protected ae 
by removing the tab from the notch in the side of the disk (the 
exact opposite of the procedure for the 5.25-inch disk). This is 
illustrated in Appendix E, Figures E-2 through E-5 on pages 127 

through 128. 
| 


The Winchester disk has no means to mechanically write protect 
it, All protection of the Winchester disk must be performed 
elther by selecting electronic write protection, by setting the 
write protect switch on the Z67 (the 8~inch floppy disk also has 
this capability) to Read/Only, or with software by utilizing 
CP/M's write protection facilities. For specifie information on 
_ these facilities, refer to pages 5 and 6 of the manual written 
by Digital Research that is entitled "CP/M 2.0 User's Guide For 
, CP/M 1.4 Owners", Additional information may be found in the 
Digital Research manual "An Introduction to CP/M Features and 
Facilities"; specifically, refer to the "STAT:" command where Bt 
the temporary protection option is described on page 14, Ce 


wn 


al 
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-' In The Beginning Disk Handling Procedure 


As an additional precaution, it is also advisable to take floppy 
disks out of the drives during power-on and power-off to prevent 
any accidental writing on the disk. This is recommended because 


transient voltages occur when a power switch in a circuit is 


opened or closed. These transients can act as a phantom command 
to read or write to the disk, damaging data that might be stored 
there. 


"In spite of all precautions, disks can still become damaged. It 


~- fs a good idea to "back-up" your files as often as is practical 


by duplicating the disk(s) you are working with and storing the 


“duplicates in a safe place. Then if something should happen to 


your original disk, you can restore your files from the last 
time you made a back-up. Making a back-up is covered below under 


"Section Five: Creation of a Backup", on page 16. 


_Systems that utilize an 267 may also use BRS.COM (Backup and 


Restore System Utility) for backup creation. This utility is 
covered in Chapter Five on page 67. 


In The Beginning | he Cold Boot/Primary Device 


Section Two: Booting from the Primary Device: 


CLD aml ST ETL beeen ELT ETE eee e 


For The H/Z89: 


The H/Z89 computer allows the user to boot from either a 5.25- 
inch disk, an 8-inch disk (if either an H/Z47 or an 267 disk 
accessory is attached), or from a Winchester disk (if the Z67 is 
attached) after the Winchester disk has been partitioned. In 
any case, the initial boot will be accomplished from the device 
that is selected as the primary disk drive in the system. 
Switch SW-501 on the CPU Logie Board inside the H/Z89 determines 
what the primary drive in your system is. (See Figure C-2 on 
page 124, Switch Contiguration on page 122 and the H/Z89 | : 
Operations manual for details). | 


The primary drive for an H/Z89 is typically set to the 5.25-inch : 
drive located on the front of your computer, to the right of the , 
display screen, 


Follow these steps: | : - 


yee 


on '--Turn on your H/Z89 computer and your disk drive accessory (if 


é--Then insert the disk labeled "CP/M Distribution Disk I" into 
__the primary disk drive for your system, 2. 
The disk is inserted with the label side toward the door, and 
the long slot in the disk envelope toward the rear of the 
machine, This is illustrated in Appendix E (figure E-1)._ 


NOTE: If the primary drive is the Z67, place the 
disk into the floppy drive (assuming you bought the 
8-inch media). 


3=--Carefully close the door of the disk drive when the disk 
has been fully inserted. 


When the terminal display has warmed-up, it will display an "H:" 
prompt in the upper left corner of the screen. 


4—--~Type B (or lower case "b"), 
NOTE: If the primary drive is the 267, type Bi. 
aa The computer will complete the command by spelling 
the word "Boot 1", This will boot thé 8-inch floppy 
a disk drive. 


; 5--Then press the RETURN key. | Cp 
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; In The Beginning The Cold Boot/Primary Device 


The disk drive should become active, indicated by a small red 
light located on the front of the drive. The computer is now 
reading in the CP/M operating system. > 


- After a short period the computer will display the message: 


32K Heath/Zenith CP/M 2.2.03 
FOR{type} DISKS WITH OPTION(S){code} 


where the "03" is the current implementation number of the 
software, and "32K is the amount of memory that CP/M is 
currently configured for (this does not signify that there is 
only 32K of memory in the computer; if "32K" is smaller than the 
aetual memory size of the computer, CP/M will need to be told 
differently; see: Section Six "System Optimization" for further 
details). The "type" will be the disk type(s) that the BIOS is 
configured for, and the "code" will show the options that are 
currently selected (more information on the option "code" ‘is 
given on page 112 under "BIOS Options"). The Configuration 
program begins automatically at this point and its beginning 
display will appear. (The Configuration Utility is covered on 
page 92.) 7 


You have now successfully booted CP/M! This procedure is 
referred to as a cold=-boot. | 


If the message does not appear, you may try again by: 


_—__-_j--pressing- the SHIFT key-located.on-the righthand-side—of-the.— ——_. 


keyboard, and 


2--Simultaneously pressing the RESET key. 


~“Phis will return your computer to the "H:" prompt, so that you 
may reattempt to boot. oe 


For The H8: 


You must have the Extended Configuration Option (H8-8-8) 
or the Z-80 CPU board (Ha-8-6) installed in your H8 in order to 
run this version of CP/M. When you install the modification, 
you will determine whether 8-inch floppy disk drives (H/Z47) or 
5.25-inch floppy disk drives (H/Z17) will be the primary device 
in the system (see the manual for the Panel Monitor XCON-8 for 
details). If an H/Z17 and an H/Z47 are both used, one will be 
designated as the primary device and the other will be the 
secondary device. With either type of device, the primary drive 
(drive A:) will be located on the left. 


Follow These Steps: 


Jje--Turn on your H8 computer, terminal, and any disk drives 
connected to the system. 


Allow the video terminal to "warm up" until the cursor is 
visible. 


In he Beginning | | he Cold Boot/Primary Device 


2--Insert the disk labeled "CP/M Distribution Disk I" into 
the primary disk drive for your system, 


The disk 18 inserted with the label side toward the door, and 

tne long slot in tne disk envelope toward the rear of the 

machine. Tnis ig illustrated in Appendix E, 

3--Once the disk is fully inserted, carefully close the door 
of tne disk drive. 


4--Press the number "1" key on the front of the H8&. The display 
on the front of the H8 should read 


Pri H 17 


if you are using an H/Z17 aS your primary device. : If you are 
uSing an H/Z47 as your primary device, the display on the front 
of the H8 should read ” | 


~ Pri H 47 


The disk drive should become active, indicated by a small red 
lignt located on the front of the drive. The computer is now 
reading in the CP/M operating system. 


After a snort period tne computer will display a message such 
as; 

32K Heatn/Zenith CP/M 2.2.02 © 
FOR{type} DISKS WITH OPTION(S) {code} 


,. Software, and "32K is the amount of memory that CP/M is 


currently configured for (this does not signify that tnere is 


only 32K of memory inthe computer; 1f "32K" is smaller tnan the 


known memory size of the computer, CP/M will need to be told 
differently; see: Section Six "System Optimization" for further 
details). The "type" will be the disk type(s) that the BIOS is 
configured for, and the “code" will show the options that are 
currently selected (more information about the options code is 
Biven on pageii2 under "BIOS Options"), The Configuration 
program begins automatically at this point and its beginning 
display will appear. (The Configuration Utility is covered on 
page 92.) 


You have now successfully booted CP/M! This particular method of 
booting is referred to as a cold=boot, Se 


Where tne "03" is the current implementation numbeér of tne = 


Ne; 


« 
SS Seema mee ee vm mapper ee OEE: ND A Se OTIS STIS LEO ELIT © 0 AN | CNET 


ey 
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“If the message appears garbled, you are probably using an 


unexpected baud rate. This situation is easily remedied by 


_typing a few spaces on the space bar of your terminal to let the 
. eal know what baud rate is being used. 


- we 


“Tf no message appears, you may try pressing the space bar a few 
“times, in case of an unexpected baud rate, 


If no message has appeared after typing the spaces, depress the 


"How key on the front of the H8 simultaneously with the "RST/0O" 


vr 


ey. This will reset the computer and allow you to try the boot 
again. 


/* ' 
a « : . * : F ied . Ps , Be xe * 
. 98 9 Paras Te Ane eo wD oSouae de é sete eee agg dal ee SE cee St a ic eC ol ao 
Py saab Gtshahs cin cine Mapebee eh lta e Te eRe Mit SELAH ote: 
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: = RETR PE 6 BE se 
* . Ehlers ee ee tT 


Bection Three: Booting from the Secondary Device: 
3 The Cold B ‘Boot 


ad as ns - 


- 


Tawexe- the Distribution Disk (“Volume I" if your disk set is on 
o.25-ineh media) into the leftmost drive of your secondary 
device oo the Foe) OW SNE steps. 


oe 


For The H/289¢ © <5 St ett BH 


If, your” H/Z89- has: multiple drives connected to it, you have the 
Option of” booting from a device that is not specified as the 
primary: device. “To do this, the user shovld: 


Cae 
w 


ln~=Type B 


As before, the computer will complete the command spelling the 
word "Boot", : 


2--Now type S$ 


NOTE: If the 267 is set as the secondary device, 
you will also need to type a 1 after the "8S", so 
that the floppy in the 267 is activated (assuming 
that you purchased the 8-inch media). 


The computer will complete the command by Gisplaying nspn which 
soci cates ae ‘boot is to oceur from a secondary device 


4 

i 

4 

t 
Pec oy i 
ee” SN oy 
Rate ! 2 

+4 


3--Press the RETURN key. 


The remainder of the boot process occurs as described above in 
Section Two, 2... 00 es eS a 


. For The H8s | | = 
If you have an H/Z17 and an H/Z47 eonnected to your system, you 
have the option of booting from a device that is not designated 
as the primary. Then do this: 


1~-Press the number "2" key on the front of the H8 instead of 
the number "i" key, 


The digplay on the front of the H8 will read 
SEC H 17 


af the H/Z17 is the secondary device, or 


SEC H 47 


if the H/Z47 is the secondary device, 


The remainder of the boot process is identical with the boot 
from the primary device listed above in Section Two, 
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SSection Four: phencerc System Configuration.. 


RA Lm es Marte Te ET = oe = 


Bremen ew ews 


Directly after the system “is Sore booted, a program begins to 
autiomatically:run.::.This program-is-the: Configuration Utility. . 
(listed.as CONFIGUR.COM on-the Distribution Disk) and is.used to 
set-up, change, or-modif.y.-the configuration of tne CP/M 
Operating system to match a particular hardware environment, 
When itrbegins:the terminal will display something similar to: 


Sf S2K- HEATH/ZENITH.CP/AM 2.2603 65 cerres 
ren cat FOR Z67 :- DISKS. WITH. OPETONLS): Pedr: 


~- < - = we = « 
tie 2 ae ME * © dy a re ra a 
‘ - a3 _ a o : ee i 4 


t-- VERSION 2.2.03 
SERIAL pep Eas nnn- nonnan 


: - 
< bike Panel ~~ Pm Fi ume 4. ae s 7 ¢ 
 S ene ee, Se Sos toe et’, se * 3 : ie Sane vw t ~2r-s Pat A aol aed os ~ = we 
ea © - «© © «6 


won THIS. PROGRAM CONFIGURES te. CP/M OPERATING SYSTEM To A 
de HARDWARE ENVIRONMENT. 


tt am 
3 oe 


PLEASE WAIT epee ARs VENUE ede ae 


H/Z89 WITH 64K OF RANDOM ACCESS MEMORY. (RAM) 
267: 8 INCH HARD/FLOPPY DISK INTERFACE ..._ .. 
CRT BAUD RATE IS 9600 . .-._:. pecs. 2 

OO ADDITIONAL PORTS FOUND 


ca 


nscale bien WRITE “PROTECTED ~~~ 
| MODIFICATIONS WILL NOT BE MADE TO THE DISK FOR THIS CONFIGUR RUN. 3 


STANDARD SYSTEM (Y. OR.N)2_<YD 2.0 ee 


This configuration utility is detailed in Chapter Six of this - 
manual, on page 92, Until this manual has been completely read, 
vou ECeROn ES to the 2 | 


“ STANDARD SYSTEM CY OR N)? <Y>: 


prompt should be either just a ¥, or by pressing RETURH. CP/M 
will then display the command mode prompt (A>). Do not ask for a 
non-standard system by typing B until you have completed Chapter 
Five. A "standard system" configuration may not use all of your 
existing hardware to its optimum but it will not need to do so 
until you have a firm grasp of CP/M. 


The Standard System Configuration values that will be set in the 
BIOS (when you ae Yor press RETURRB to the Remi are shown 
on page 96, | 


SNe re meee marr emenmenen., yma ein yem seeenep ie ee owapa get 


sl alienate dlnemrinadlltead x tnteamnnntelanttlices ietiinttn temic cattaameans atte 1, ee tiene idan teeta anna inline Yo, tartan dane 
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~ 


Section Five: Creation ofa Backup 


whaspmemnle ss 85 gies 


It is extremely important to maintain a backup copy of your 
Distribution Disk (or Disk Set), and for the first time user of 
CP/M it is perhaps even more important. Though CP/M 18 easy to 
use once it has been learned, the learning process does take 
some time and so this section was created to guide you through 
the generation of a backup copy with a minimum of effort and 
only a minimal knowledge of this operating system. 


The first need is to determine what type of operating 
environment is being used (what equipment does the total system 
consist of and now is it configured). Next, dependent upon that 
Operating environment, a series of procedures is outlined. Each 
procedure is alist of steps that need to be performed to create ‘ 
a backup disk. Tne operations that are performed while 
following these steps are not explained with any detail where 
they occur in the step-wise procedure, but tney are all 
explained further on in the appropriate sections of this manual. 


‘if ; : 
~~ \. Drive Name Determination: 


Tnere 1S one more thing that needs to cover before continuing 
With the creation of a backup copy. The drive name assignment 

Sse Ss for the drives.need tobe determined (unless-you-have-only—a-— 
Single drive system, in whiecn case the drive name is "A:"), The 
drive that the boot is performed on is always Drive "A:"! 


- For the HEATH/ZENITH H/Z89 Computer: 


Boot Device Names Possible: 
H/217 A:, Bi, C: 727 A:, Br, C: 
H/Z47 A:, B: | 267 At, B:, C: 


(See "Appendix F" for Illustrations of Drive Name Designation.) 


NOTE: Only one Primary Device and-.one Secondary 
Device may be connected to the computer. A system 
can support only two device types. In the table 
ete below, the three devices that are given below each 
fre "booted device" are the three alternate device 
° possibilities. Only one of the three may be used 

i in conjunction with the "booted device", 


“In “Thie - 


we wes rd - ae 
ee oS w 
wr + * - 
ee ee 
5 al ~ fo - 
=~ = oe 
>-_ ler lw ho” cd 
= ~ Ld 
- 


” 
- - -_ 
. r 


-Beginwing 


Initial Boot to H/Z17 


 Secondarv Device Names 


. (Booted Device) 


~ 


2202 D2) Anitial Boot to 237 
ce Names 


‘areperr~ Gagendeey Device 


— (Booted Device) 


_Senenears y Device cit 


(Booted Device) 


Initial Boot to Z67 
Secondary Device Names 


(Booted Device) 


Names 
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. 
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wn“ 


Boot Device Names Possible: 
H/217 At. Bas: iC  H/ZAT Av < BD: 


Initial Boot to H/217 
_* secondary Device Names 


2 H/217 As, Bt, C: (Booted Device) 


Initial Boot to H/Z247 
Secondary Device Names 


H/Z47 AS. B: (Booted Device) 
H/Z17 Cin. Diy. Ee 


Perform a cold boot on your system, exactly as covered in 
ow, "Section Two" above. The terminal on your system will display, a 


32K HEATH/ZENITH CP/M 2.2.03 | = S 
FOR{type} DISKS WITH OPTION(S){code} 2 2 
and then it will continue with the Configur program, giving the 
display that is-shown in "Section Four: Standard System | 
| Configuration", After answering "Y" for a "Standard System", 
i ede: WEE GS pays. eteter ek oe ee oehibetes eh: GNeeeeee ae OS 
A> - 
The "A>" is CP/M's Command Mode prompt. It lets the user know 
that CP/M is awaiting a command from the user. 
The following is not the best way to determine the name 
assignments of each drive in your system but it is quick. 
Place disks in all of your drives, close the drive doors and 
type in Bs and press RETURN, thus: 
ADB: RETURN 


Watch the small lights on all of your drives to see if any of 
___» the drive-active lights come on. The drive with the light that 
ie comes on briefly is the drive named "B:", If either no disk or 
a disk that has not been properly initialized has been inserted 9 
- into drive B:, a BDOS select or bad sector error will occur. 
Pressing RETURH or CTRL and C in the event of this error, will 
return the system to the A: drive. These errors also will occur 
here if the drive door is left open. 
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Fot NOTES T‘THé Winchester Disk in the Z67 system does 
not have a drive-active light. No name assignment 
will have beén::made until after the ASSIGN command 
has assigned a drive name to at least one resident 
EPE°" partitions:. This drive usually makes soft clicking 
noises when it is being accessed but the major 
report of itsiactivity will be by what is displayed 
on the monitoére:-.- 
Witéhn a properly Intialized disk is inserted and the door is 
closed on the "B:" drive, the screen would Show a new prompt: 
hree Ce. : 
B> 
init: 
Depending on whichSdrive has been “logged on", the command mode 
prone TT. Perey the name assigned to the légeed drive. | : 
‘This Selieeee: of CP/M considers logical drive names A: through F: 
"to be valid: though you must have one to six corresponding drives 
connected and with their power switch set to "ON" for these 
names to be recognized. If your system has three drives 
| connected, the names “A:", "Bs", and "C:" would be the valid 
| ‘drive names. (See: "NOTE", above, if you have an Z67. If you 
a ‘Boot: up on the 8-ineh drive of the 267, it will be the "Ai" 
AC drive. The Wincnester disk in the Z67 has no name assignment 


until -after you have run the ASSIGN utility.) 


“T6 “log on another drive, type in X: (where "X" is tne — 
“eorresponding drive name) and press RETURN. Take a moment and do 
‘this using the names "A:" though "F:" to determine what the 
‘names of each of your drives are. | 


NOTE: ‘Te you neprocned a cold boot on the Primary 
Device, the physical drives will be assigned 
different names than if you performed a Secondary- 
“-Device coid boot. The specific drive that a boot 
-is performed on is always designated as Drive A:. 
(See "Appendix F" for Tllustrations of Drive Name 
Designation.) 


If a drive name is requested for a drive that does not exist, 158 
not connected to the system, or does not have a disk in it, a 
-~BDOS error: message will appear: | 


BDOS Err on X: Select 
‘In this prompt, "X:" is the drive name ttrat was requested by the 


-user. This error state may generally be exited if tne user 
presses RETURR. : 


ea % - ees -* oa + * ~ - . oo -#. . . ia Pa a A 4 fied oe ~ : ag ey ’ a 
ong pacteutiteasbilae Maint Ob idee rime | : Cities : os & anhonn cee tte lati thet. mil YS goad : : wiatys. 2 Retin Sede eee) eee aoe : fant, Be Babak canal: 
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Backup Procedure Determination: ne 


Depending on which particular operating environment you have, — 
you will use one of three procedures, To determine which 
procedure to follow, look at the following sets of questions to 
see which of the three types your system is considered to be: 


@ Do you have only one individual disk drive, or more than one 
disk drive but none of them use the same controllers? Follow 
"Backup Procedure One", on page 21. 


@ Do you have more than one disk drive, where at least two of 
the drives use identical media (the same type of disks)? 
Follow "Backup Procedure Two", on page 24, 


6 Do you have only an H/Z89 computer and an Z67 Winchester 
Disk System? Follow "Backup Procedure Three", on page 27. 


te 
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we 


r 


Backup Procedure One: Single Disk Drive systems 
Cold-Boot 

1--Perform a Cold-Boot, as. was covered above. 
The Computer will respond with: 


32K HEATH/ZENITH CP/M 2.2.03 
OR CGe Des DISKS WITH OPTION(S) {code} 


3, 


and then continue with the Configuration program. 


Configuration 

d--After you see the prompt, type Y to ask for a "Standard ‘ 
System" (see: Section Four, above). The computer returns to 
the command mode and displays: 


A> | 


FORMAT Ve 


é ie 
Ay 
SN ‘ 


3--Type in FORHAT and press the RETURN key. 
——-—-- -—---The-FORMAT-program- will display a few-sentneces and then-ask- you~ -———--— 
"Ts that what you want? (y/n):". The "(y/n)" means that it 
expects a “yes" or a "no" answer from the user, 


Ke--Type in a Y. 


FORMAT will ask “Which drive do you wish to use for this 
operation?:", 


S--Remove the disk that is in the drive. 


6—--Place a blank disk into the drive you just removed the 
Distribution Disk from. 


T-~Close the drive door securely. 

8--Type A and press RETURN 

If your disk drive controller is an H/Z17, the following two 
questions will not appear. Skip over .f~hem and go to step i1. 


Sere a If the disk drive controller is a 237, you will be asked "Which 
Vues Density?", 


By convention in Heath/Zenith software all responses to 
prompts should be terminated by a RETURN with the excepticn of 
the requests ending in "3", 


: Aw we ee ee a Vere tag beens 8 Pitan. es a 7 = : 4 iss. — re “=. 
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ec 


9--Type S 


If the disk drive controller is a 237, the program will ask 
"Number of Sides?", 


10-~-Type 1 
The drive light will indicate that the drive is active. There 
will be a pause while the program formats the disk. When it has 


finished, FORMAT then asks "Do you have more disks to format? 
Cy/n):" 


1i--Type N, unless you have more than one disk to backup. (Tf 
your Distribution Disks are on 5.25=incech media, you will 
want to copy each of the three disks in the set. For 
multiple copies, return to step 4 and type Y ) 


FORMAT will tell you to "Place a bootable disk in drive A and 
press any characters", | 


12--Retrieve the disk just formatted from the drive and replace 
it with the Distribution Disk. 


13=-Press RETURN 
You will now see the CP/M Command Mode prompt: _ 


A> 


SYSGEN 


14--Type SYSGEN and press RETURN 

SYSGEN will ask "SOURCE DRIVE NAME (OR RETURN TO SKIP):", 
15--With the Distribution Disk in the drive, type A 
SYSGEN will state "SOURCE ON A, THEN TYPE RETURN", 
16—-—-Press RETURN 

SYSGEN will pause, then ask "COPY BIOS.SYS (Y/N):", 
17--Press WN. Do Not Hit the "RETURN" key! 


 SYSGEN will pause briefly this time, and then ask "DESTINATION 
DRIVE NAME (OR RETURN TO REBOOT):". 


18--Remove the Distribution Disk, and replace it with one you 
have just formatted. 


19--With the drive door closed, type A 


SYSGEN responds "DESTINATION ON A, THEN TYPE RETURN", 


2 ae CS TGS mae Ge OM weeengy ++ te eo 


ee aes 
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a 
~~ 


20--Press RETURN 


21--When SYSGEN asks "DESTINATION DRIVE NAME (OR RETURN TO 
REBOOT):", replace the newly “sysgened" disk with the 
Distribution Disk. Or if you have more disks to be 
"sysgened", return to step 18 and repeat the process with 
another disk. : | 


22--Press RETURN 


PIP 


23--Type PIP B:=#,#{B] 
24--Press RETURN | | 


PIP will cause all of the files on the disk to be copied onto 
the disk that you formatted and: sysgened. It will read 
information from the distribution copy, store that data in 
memory, and then request that you "Place Disk B in Drive A: then 
press RETURN.” The "Disk B" that it refers to is the new one 
you are creating. It will then ask for disk A. 7 


Alternate the disks back and forth when it requires you to do 
so. Be certain that you always place Distribution Disk I in the 


you are using to make a copy, in the drive when it asks for disk 
B, 


CAUTION: Do sot touch the keys on the keyboard, 

“except the RETURN key and then only when you are 
asked to do so, while this8 operation is taking 
place, Doing s0 May cause the PIP operation to 
abort and you would have to start PIP again. 


As PIP copies each file over, it will tell you the name of.the 
file that is being copied. When it has completed, you will see 
the "A>" prompt again, At this point you will have made your 
first Backup copy. If you have 5.25-inch media, you will need 
to PIP the files from each of the three Distribution Disks to 
three different "formatted" and "sysgened" disks. Return to step 
23 until all of the Distribution Disks have been copied. 


Ending 


25==Store the original Distribution Disk(s) in a safe place. 


26—--Prepare a label for the new disk. Be certain to include the 
required copyright information. 

Now, @6 On to "Section Six: Typical System Use" page 33, for a 

further discussion of CP/#, 


_Grive when it asks for disk Az: and that you place the disk that... 
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Backup Procedure Two: Hulti-Drive Systems with Identical Hedia 

Cold-Boot | 

1--Perform Cold-Boot, as was covered above, 

The Computer will respond with: 


32K HEATH/ZENITH CP/M 2.2.03 
FOR{type} DISKS WITH OPTION(S) {code) 


Then the Configuration program will begin automatically. , 
Configuration 

2--Ty pe Y in response to the "Standard System?" prompt. 
Throughout this particular procedure, the drive containing the : 
Distribution Disk will be referred to as the "Source" drive. | 


The other drive, using identical media, will be referred to as | | 
the "Destination" drive. . 


FORMAT 
3--Type FORMAT to the prompt shown. 
~~~ -For-example, -when--you-type im "FORMAT"; it-would appear “as: 
A>FORMAT | 
4N--Press the RETURB key. .. ........ 
A>FORMAT RETURN | = 


The screen will display a few sentences, und then ask "Is that 
what you want? (y/n):" 


The (y/n) sig rifies that a "yes" or "no" answer is required by 
the. question. 


5--Type Y. Do Not press RETURN! 


FORMAT will then ask you "Which drive do you wish to use for 
this operation?:", 


6--Type in the character name of the drive where your 
destination disk is located. 


By convention in Heath/Zenith software all responses to 


prompts should be terminated by a BRETURH with the exception of 
the requests ending in ":", 


= 


 J4e-When asked for the destination unit,. type in the character 
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If an H/Z17 disk drive controller is being used for this 
Operation, the next two questions will not appear. Skip over to 


Step 9, if you are using an H/Z17 controller. 


If you are uSing either the 237 or the H/Z47 disk drive 
controllers, FORMAT will ask "Which Density?", 


7--Press S&S. 


If you are using either the 237 or H/Z47 disk drive controllers, 
FORMAT will then ask "Number of Sides?", 


8--Type 1. 


There will be a pause while your disk is being formatted. The, 
destination drive should indicate that it is active. It also 
Will make a bit of noise during the operation. 


FORMAT will next ask "Do you have more disks to format? (y/n):". 
If you have more than one disk to copy, return to step 5 and 
type Y. If you have only one disk to copy, proceed with step 9. 


FORMAT will then tell you to "Place a bootable disk into eas 
drive A and press “4 characters", 


1OneP Pens RETURN. 


CP/M will now show the prompt: 


DUP. 

li--Type DUP (followed by pressing the RETURN key). 

The program will identify itself, and display a list of options. 
12=--Select option "A", "copy and verify", by typing A. 
13=-When asked for the source unit, type A 


This is the lettername ofthe source unit. 


determined as the destination unit name. 


oo 
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NOTE: If an 8-ineh disk is being used as the 
destination, it must be write enabled by placing 
one of the tabs that are especially provided from 
the manufacturer with blank disks over the notch 
in the side of the disk. Do not use tape! Tape 
can get adhesive on the disk's recording surface. 
The sensor also uses an infrared LED, and many 
tapes are transparent to infrared so it may treat 
the disk as if the tape were not there. 


15--Now place a blank disk of the same size and density as the 
Distribution Disk, into the Destination drive, 


16--Close the drive door. 
17--Press RETURN to begin the copying operation. 


The disk drives will become active as the entire disk is 
duplicated. 


Repeat this operation by returning to step 12 for each of the 
Distribution Disks (if they are on 5.25-inch media). Insert a 
different Distribution Disk and a different destination disk 
each time you repeat this procedure, | 


— '18--After the copy and verification operations are complete for 


all the disks, remove both disks and place "Distribution 
Disk I" in the A drive. Type Z. 


eugene 


19-~Store the ae Real Distribution Disk in a safe place, 


20-—-Prepare a label for the new disk. Be certain to include the 
required copyright information. | 


Now, go con to "Section Six: Typical System Use", page 33, for a 
further discussion of CP/M, 


8e 
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Backup Procedure Three: oot Winchester Disk eo wee 


o~ ~~ - ._ = wf 


PART Re ne aS Be Ee ee Gee oe 

j<cbertorn PART (it it: is. not: oedeeady sone). the partitioning 
progfam ‘that -was- ‘provided with ‘the~- 267 Winchester Disk 
System. This-is the only stép in this ‘procedure that requires 
extefnal:informatiion.” The instructions for PART are in the 
manudl<that came: with the floppy disk: that was provided with 
the Z67. After PART is performed, you will need to place the 
‘Di-stribution Disk: ‘into ‘the: rs ies drive® of the Z67 then 
continue -with’this-:procédurel,’ ©¢s.i5t22. 


oe - ~*~ . . 

4 2 a p>» - y a an Ct a i ad 
Cold-Boot :: wrt Crvive cice. 
A CAD YASS 


. 


2-—-Perforim -a'Cold-Boot,: as. was ‘covered above, 


- - 


The ae seed Will respond with: 
32K HEATH/ ZENITH CP/M 2.2.03 
eo DISKS | WITH EES ea! 


mo — © + @ we wee el 


Then the configuration pobre will begin Gonaceey. 


~~ - 
~~ 


Configuration 
~3--Type Y in response "to pre err rer & System?" prompt." 


Throwsnout this particular procedure, the floppy drive 
containing the Z67 Distribution Disk will be referred to as the 
"Source" drive. The other drive, the hard disk, will be 
referred to as the "Destination" drive, | 


ASSIGN 
H--ASSIGR ? followed by a RETURN is then typed in by the user. 


The computer will respond with something similar to: 


“ MAXIMUM 
PARTITION NAME OCCURRENCE NUMBER 
CPH 2 


“which shows that the user set boundaries with PART, the 
___»Partitioning Utility, for three seperate partitions--CPHK:0, 
CPH;:1, and CPH:2. 


By convention in Heath/Zenith software all responses to 


prompts should be terminated by a BRETURB with the exception of 


the requests ending in "3", 
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35 28In Phe Beginning ; ST #: Creation of ‘a -Backup 


} iil ag Mea, 
Saree 
3 . re Ue 

~ -° ERs 


Broxer Sc°tNOTES: This is only: an’ example of “ttre display that 
auser receives. The "Partition Names" that show 
on the display would be those names that were 

- Assigned by the user during PART'sS operation. ff 
multiple partitions were not named with the same 


“~-*=2" [25 * mame, then the. maximum. occurrence number’ for. each 


prcyg" 2 partition:name would-be 0. (zero). - If the same. name. 
Sainiey .were: used: for:.two: different: partitions," 1 (Cone) - 
€34£°r wourd :be the: maximum’ octurrencte number. <:If the: 
#2Tcf. Wame were used on’ three:partitions (as:was-the-case.- 
tre it” for “this ‘example),: then 2:is:the: maximum occurrence: | 
Listiv i hnumber.-:The first occurrence Of ainame is’always 0: °° 
eorlin.€ézero), the: second: occurrence is 1 (one), the third 


is 2 (twos: the fourth is 3 (three), and so on. 


‘ 
Oo 1 UNANGLT “Poet te ceme . 


Se ee 
. _BarSelect a CP/M pero Eas eene eee 
6=-Type ASSIGE ‘Brepartition-nane; n and eres the RETURN 
Eo ahr OY. Yaa ne 
Here; "partition-name" must be the name of a partition, which 
was shown during Step 1, that you have decided to use, The "n" 
is the Me ae ee one 4S shown HOT that particular 
Amn, . ai ae partition. ee a ~ oS ws ee on ee — (Oe ‘ 
_2. .JTe=-Type ASSIGH and press RETURN 
= Phas should 1 list the “partition that. you have just assigned and 
any that you may have previously assigned. An example might be: 
A>4SSIGE a Se eee a eh as dee eee ee teens 
B: = CPM 7 
_.. Device "Bs" will be your Destination Drive during the next 
procedure, 
FORMAT 
8--Type FORMAT to the prompt shown, 
For example, eHeD you type in "FORMAT", it would appear as: 
A>FORMAT 
"=" Qee Press the RETURE key. 
A>FORHAT RETURN 
- The screen will display a few sentences, and then ask "Is that (7 


what you want? (y/n):" 


The "(y/n)" signifies that a "yes" or "no" answer is required by 
the question, 


ranger Gere megs ware 5 ea. 
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in Creation of a Backup 
| 10--Type.. x. See ee eee | ™ 

FORMAT waa the ask. you "Which drive do you wish to use for this 

operation?: We ee 


li--Typéin ‘Bo ue ene 


The computer will’ “request "PRESS RETURN TO BEGIN." 


12--Pres¥=RETURN °° =>. 


fre 


There wiTtl be: a pause while your disk is being formatted. The 
destination drive should make a slight noise during the 
operation;* which” will Tet you know that it is operating. 


° - = . : = z 


- - P 


FORMAT will next ask | eee you have more disks to format? (y/n):", 


f - 
ot ae ~. c ~ 


Noe yee. N. - . _ 


- mf Ss 
; Re ee 


- 


FORMAT’ - will then tell you to "Place a bootable disk into into 
drive A and press any character:",. 


1H-=Press RETURN. = - 


CP/M will now show the prompt: 


oo. 2 ieee a ~ re : 
lo--Type SYSGEN and press RETURK. a | 
“.SYSGEN will ask "SOURCE DRIVE NAME (OR RETURN TO SKIP):". - 
16-—-With the Distribution Disk in the drive, Bae A. 
SYSGEN will state "SOURCE ON A, THEN TYPE RETURN". 
17--Press RETURN 
SYSGEN will pause, then ask "COPY BIOS.SYS (Y¥/N):". 
18=--Press H. Do Not Hit the "RETURN" key! 


SYSGEN will pause briefly this time, and then ask "DESTINATION 
_ DRIVE NAME (OR RETURN TO REBOOT):*. 


——- 19--Type B 
(am 
| SYSGEN responds "DESTINATION ON B, THEN TYPE RETURN", 


x. an 


a ca Beate Soe Rite DOANE ereption SATAN AIN RM aR ale eb ede eae me Ge tener Be i te canes alge adghes he i nL © 1 A tebe ¥ Sao cea meat A em ee te me ee t eo} 2 rode . ely FSGS beg 
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24e-Perform a cold boot on the Winchester Disk in the Z67. 


ise Sieh HBR 2 ON Te se Pd Mes iia gre ie eg ee ee a 


Configuration 


in Ihe Beginning Creation of a Backup 
20--Press RETURR 7s 


After a few moments SYSGEN will ask "DESTINATION DRIVE NAME (OR 
RETURN TO REBOOT):", 


21i—--Press RETURN 


CP/M will again display the command prompt "A>", 
PIP 


22--Type PIP B:=A:®.@[R] and press RETURN 2 
PIP will transfer all files from the Source Drive, "A:", to the 
Destination Drive, "Bs", The name of each file will be printed 
on your monitor as PIP begins to transfer it. Unlike DUP, PIP 
may be used to transfer data between any type of media. : 


Cold=-Boot 


23--When the command mode prompt ("A>") appears again on your 
monitor, place a blank disk into the floppy side of the 267. 


The Computer will respond with: | Yes 


FOR{type} DISKS WITH OPTION(S) {code} 


Then the Configuration program will begin automatically. 


25<=--Type Y in response to the "Standard System?" prompt. 
The Winchester disk will now be the "As" drive, 


FORMAT 


26—<-Type FORWAT and press RETURK. 


FORHAT will print a few beginning statements and then ask "Is 
that what you want? (y/n):*. 


2T--Type Y 


FORMAT then asks "Which drive do you wish to use for this 
operation?"., 


28--Type the drive name now assigned to the 88-inch floppy of the 
Z67, C 


+n, zibe Beginning Creation of a Backup 


-FORMAT. will.ask "Which Density?". . 
ae9erly pe ms GN = a nae esa ® ao . : Ee. aoa = : - 


as . é 
wo ee Se ee 


30; r-Press. RETURN bo begin. a ee oe 


fae 2S Ce ee _ Weer mele 


kf ter the disk is formatted, FORMAT will ask "Do you have more 


Ps zdisks, for format", FEL ene press FETE: 
s3t--Type .N. ee ae ee ee 
peeés. will. return tothe command..m ode prompt, displaying: 
c- fe Zo ee ee See ee Ee 
sev re ter ve terete Chit peteter ¢ 
eee 


_32--Type SYSGEW and press RETURN. 


SYSGEN will print out a couple of sentences and ask "SOURCE 
-DRIVE NAME (OR RETURN TO REBOOT)". 


-33--Type A and press RETURN. 


JS YSGEN Wi) eee. AS iM COPY aBIOS SVS. 20Y N68 ie 5 ico tke ae 


34asPpress E. Do not press RETURN 


After a moment SYSGEN will prompt with "DESTINATION DRIVE NAME 


Se RETURN TO REBOOT)", 


35--Ty pe C and press the RETURN key. 


After it has generated the system, SYSGEN will prompt again with 
"DESTINATION DRIVE NAME (OR RETURN TO REBOOT)". 


~36~-Press the RBETURB key. 


SYSGEN will exit and the command mode prompt ("A>") will. be 
displayed. 


PIP 
37--Type PIP C:=A:#.8®{B] and press the RETURN key. 


PIP will now transfer all of the files to the Floppy Disk that 
you had copied to the partition of the Winchester Disk. Again, 
PIP will display the name of each file when it begins to copy 
tonat file. 


fe 
$ 
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in The Beginning ' Creation of a Backup 


When PIP has finished, you will see the CP/M Command Mode prompt 
displayed on your monitor. You now have the original 

Distribution Disk, a duplicate of that disk on an 8-inch floppy 
disk, and the operating system is resident on a partition of the 
Winchester Disk. The method outlines above will not create a 
backup of the distribution set with BIOS set to R/O (Read Only) 
and to SYS (System). 


Ending 
40--Store the original Distribution Disk in a safe place, - 


Hi--Prepare a label for the new disk. Be certain to include the 
required copyright information. 


Now, g0 on to "Section Six: Typical Sy Use", page 33, for a 
further discussion of CP/M, : 
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In The Beginning Typical System Use 


section Six: Typical System Use . 


To reboot your H/2Z289 using the newly duplicated disk, press the 
SHIFY key on the righthand side of the keyboard (the left one 
won't work for this special function), and while holding it 
down, press the RESET key. Insert your system disk into the 
drive that you will boot and then type B followed by RETURN or a 
B then S followed by a RETURREB if you are using the secondary 
device. (What this does is resets the computer system, and then 
tells the computer to pull the CP/M system into the computer by 
its own "bootstraps", 


An H8 is rebooted by simultaneously pressing the "0" key and the 
"RST/O" key on the front panel of the computer. This will reset 
the system. Place the newly copied disk into the primary drive 
and press the number "1" key on the front panel. The system 
will now boot from the new disk. 


Now, you should read the Digital Research manual entitled "An 
Introduction to CP/M Features and Facilities". This will help 
explain the structure and purpose of the basic commands for the 
CP/M operating system. Experiment with some of the commands. 


CAUTION: ERA (the command to delete files) and PIP 
(used to copy files) can each remove files from 
your disk. Use them with caution until you have 
fully explored their functions, 

NOTE: You can always recover from any catastrophic 
errors by creating another duplicate (a working 
backup copy) of the original Distribution Disk (or 


---~ .-disk-set if CP/M was purchesed on 5,.25-inch media). 


Hinimal System Disks: 


The next step you will probably want t» take is to create a disk 
that contains only a subset of the distribution software. This 
process is described in Chapter 4, but the key steps are: 


J=-FORHAT a disk. FORMAT is found on page We, 


2é-eRun HAKEBIOS if your system uses more than one disk drive 
controller, The instructions for MAKEBIOS are found on page 
53. If you have only one type of disk controller, proceed 
with step 3. 


3--Use MOVCPMnn to adapt CP/M to the amount of memory in your 
system. MOVCPMnn is described in detail on page 63, 


HeeUse SYSGEN to place the new system information on the blank 
disk. SYSGEN begins on page 66. 


Further, if you..were going.to write BASIC-programs,-you-could 


in The Beginning | Typical System Use 


6 RB 


w 


~ 


-- ee 


few ome a a eo & 


a So PIP wen the “OR)" ant ai. you should copy the disk 


-.- file named "BIOS.SYS" (which is a necessity to be able to 


boot from the disk), as well any other files you need to 

create a useful "working" disk. Unlike the DUP utility, PIP 

May be used to transfer files to and from different types of 
' media. 


>. Now. if you had the. BIOS.SYS file on your newly created disk, 


“it would be a good idea to set the indicatcrs of the BIOS.SYS 
file as they existed Eger iee., as R/O (Read Only) and 
SYS (SYSTEM) type. 


~ .@ 


“6=-Use STAT to’ set the BIOS.SYS to Read Only (R/O) and to System 


” 


(SYS) by typing, 


 AD>STAT C:BIOS.SYS $R/0 
A>SYTAT C:BIOS.SYS $SYS 


to set the appropriate indicators. Here, "C:" should be the 
name of the drive where the unprotected BIOS is located. 
Additional details are on pages 5 and 6 of the Digital 
Research manual, "CP/M 2.0 User's Guide For CP/M 1.4 Owners", 
and in "An Introduction to CP/M Features and Facilities" on 
page 14, 


create a disk containing the system information, BIOS.SYS, and 
the files PIP.COM and STAT.COM for file manipulation. Then you 
could transfer the BASIC interpreter from its distribution disk 


(BASIC must be purchased separately) to your "working" disk. By. 
eliminating unneeded files from this "working" disk, you gain 


more space on the disk for programs and data. It is often a good .. 


practice to generate a "working" disk for each project or 
application. 


ve 
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in The Beginning System Optimization 
dentin, 2+ section Sevens: System Optimization 


wr. - 
we meee 2% 
. 


Up- to: and ‘including all of the operations that you have 
performed. so far, you have been working with a minimal system 
configuration, If you have more than 32 K bytes (32 times 1024 
bytes): of RAM (Random Access Memory), you have not been 
utilizing it. In fact, CP/M thinks you only have 32K. 


Systém ° “Optimization is the process of determining what your 
system “does | consist of, so that CP/M may take full advantage of 
the © ~yesources that you have provided it with. There are 
basivally two main programs that need to be run at this point, 
yin.order. to take full advantage of your hardware, 


RR Se - - ep ue ee pare : 
One of tiesé two programs is MOVCPMnn, which is covered in full 
detail in Chapter ‘Four on page 63. This program lets CP/M know 
exactly how much memory you have. (If you have only 32K of 
memory then you will not need to run this program at this time. ) 


The other program is CONFIGUR, which you have come in brief 
contact with during the boot process. It is covered completely 
in Chapter Six on page 92. CONFIGUR will allow CP/M to know 
what. devices you may have connected to your computer, and it 
will allow you to tell CP/M all of the details that it needs to 
know about those devices go that it may utilize them whenever 
-you require it to do so. It also allows you to specify certain 


oo o———=———v arndable characteristics regarding the hardware, Among these —— 


variables are choices regarding baud rates, whether to convert 
output on your console device to uppercase, speed of 5.25-inch 
disk drives, and several other options. 


CHAPTER TWO: DISTRIBUTION SOFTWARE 


e A Brief Description and List for all of the 
CP/M Utilities provided on the Distribution 
Disk(s). 

© . The Basic Instruction and Operation of ASSIGH, 


FORMAT, DUP, SETLP, LIST and PREL utilities. 


In addition to the standard programs that are normally included 
with the CP/M operating system, a number of utility programs 
have been included with this product to facilitate its use on 
your system. Below is a basic listing and brief description of 
all of the programs that are included in this release of CP/M. 
More specific instructions for each of the programs listed are 
included elsewhere in this manual set. Within this manual you 
will find all of those programs listed on the Heath/Zenith part 
of the list, and details regarding the two programs marked with 
asterisks ( ) that are listed under the Digital Research portion 
of the list. Instructions to those two programs (SYSGEN and 


waa mn=-——MOVEOPMnn) are included” here because they have been extensively 


modified to fit the Been Aeon requirements. 


The Digital Research set includes the vonT owes PECEr ene: 


— ASM.COM | 8080 eer hes 


DDT.COM Dynamic Debugging Tool = 
DUMP.ASM Assembly Language/System Interface Example 
DUMP.COM Utility to Dump Disk Files 

ED.COM Line Oriented Text Editor 

LOAD.COM © Hex to Executable-File Utility 

MOVCPKnn.COM System Relocator 

PIP.COMH Peripheral Interchange Program 

STAT.COM System and Disk Status Utility 

SUBMIT.COM Command File Executive 

SYSGEN. COM Disk System Generation Utility’ 

XSUB.COM Extensions to SUBMIT to allow batched input 


of console responses within user programs. 


te 


RN EE LOI LIAL LNG ATA OIE ATID EDIE OP Et AO cB NSAI ACE a EA Xo enn SE INES OOS 


extensively modified far Heath/Zenith implementation, 
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Distribution Software | Basic Description 


The Heath/Zenith software is composed of: 


ASSIGN.COM Device Assignment Utility for Winchester 
Disk System 

BIOS.ASM Basic Input Output System in Source Code 

BRS.COM. .- Backup/Restore System for Winchester Disk 

CONFIGUR.COM System Configuration Utility to Optimize Hardware 

DUP.COM ._.. Disk Utility Program for Duplicating and 
Verifying Disk Files , 

FORMAT..COM ~ Blank Disk Formatter for Initialization 

LIST.COM :2:. Printer Driver - with Optional’ Headings and 
Pagination for Disk Files | | | 

MAKEBIOS.COM Program to Create Working BIOS 

MAKEBIOS.SUB Submit File to Create Hardware Specific 
Basic Input/Output System (BIOS) 

PREL.COM - Page Relocatable File Utility 


SETLP.COM Utility to Cnange Line Printer Baud Rate 


1g ab 0 ay PLEA rrr | ee 
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Distribution Software ASSIGN Utility 


ASSIGN | 


ASSIGN is a utility that is only used with the Z67 Winchester 
Disk. The manual that was provided with the Z67 and the PART 
program disk should be read thoroughly before reading this 
section. The manual that describes the use of PART (the 
partitioning utility) contains much of the basic material and 
definitions that you must be aware of before using the ASSIGN 
utility. 


ASSIGN is a utility that allows the user to assign logical 
device names to a partition. It also may be used to check what 
partitions are currently assigned a device name, what partitions 
are available to be assigned, and to remove the device 
assignment from any given partition. 


The features provided by this utility enable the user to treat 
the various partitions on a Winchester disk as actual, 
physically separate devices. By using the device assigned to a 
particular partition, the user may invoke CP/M programs to 
interact with the partition exactly as if that partition were a 
Separate disk drive. 


In the operation of the utility that creates the partitions on 
the Winchester disk, the user names each partition with a 


designator, which may be up to sixteen characters in length.. 


Several different partitions may possess the same names. These 
Similarly named partitions are set apart by occurrence numbers, 
Each time a name is duplicated, it is assigned a different 


number to show that it has a distinct occurrence, (Exact details. 


“regarding the setup and treatment of partitions is contained in 
~ he documentation that came with the Winchester disk. Please 
refer to that document for more detailed information.) 


For example, consider a Winchester disk that has been 
partitioned into three distinct partitions that are to utilize 
CP/M in their manipulation. Desiring to remember which 
Operating system created these files, the user has decided to 
name all three as "CPM", The first CPM, partition-name 
occurrence would be "CPM;0", where the semicolon (:) is used to 
Separate the partition name from the partition-name'ts 
occurrence, The second partition named as CPM, would be CPM:1 
(occurrence number 2), the third partition, CPM:2 (occurrence 


3). 


The four operations performed by the ASSTGN utility all begin 
With typing in ASSIGH and then are followed by distinct 
Operators that determine.what ASSIGN is to do. 


a eed eats Diet ee eee eee 
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poser purer. pottuare see Sel Utility 
pon ad Ae a a ke ea aatamee fees tae pet = ee ae sec 
Assignments Available; = 


eM West 
> ae as 


a? 


To see what assignments are possible, the user would type: 


Sih ee een S222. 28 BPRS Cees Bee ee. Be Be eee eee 
eae o es Se 2 Se Bee, Ree ee am he ew aie. Se = eee Baws “Boece 
=~ <Tne ee ee might respond. with ge ee ees Beer tes ee, 
mo eae vee See. See ee eer tees 8 ef See Bex 
foto. See 2S: Sere moe ee MAXIMUM. eee, eee 
Gee as see PARTITION NAME. : >: - OCCURRENCE. NUMBER... ,ec--: 
CPM 2 
hots Se: “a Toke eee Se Ie eee, Se eee ae SS 2 Lee te 
reviwhieh shows: that. the. user:set -boundaries-with -PART. (the 
rev Partitioning. oo for: thnree- Se DeueyS. partitd, ns--CPM;0, 
=<” t¢CPRs; 1, and CPR; 2 Be ene es Boe 4! RO ee ee. eee ee as | 
pee 2 wee, Lee. “ae ee a ee 
NOTE: This is oore an example of the display that 
[i4 T*#7° avouser> receives... The "Partition Names" that show. 
> on the display. would be those names that were 
2 ‘Assigned by. the user during PART's operation. If 
multiple partitions were not named with the same 
-— name, then the maximum occurrence number for each... 
: partition name would be 0 (zero). If the same name 
were used for two different partitions, 1 (one) 
would be the maximum occurrence number. If the 
name were used on three partitions (as was the case 
ii itsi‘(‘iéifoOV this example), then 2 (two) is the maximum Uw. 
occurrence number, The first occurrence of a name 
is always 0O (zero), the second cecurrence is 1 
(one), the third is 2 (two), the fourth is 3 
(three), and SO ON. 


Meke Assignment: 


To make an assignment, the user would request: 
A>ASSIGN Xispartition-nameisn} 


Where "X:" igs the device name, “partition-nane" is a name given 
for a currently resident partition, and "jn" is the optional 
occurrence number of that partition name 


NOTE: The occurrence number of any given partition 
must be preceded by a semicolon (3). If no 
occurrence number is specified, occurrence number 0 
is assumed, 7 


An example of this might be: 


AD>ASSIGH A:=sCPH RETUR A 
A>ASSIGN B:=CPHM; 7 RETURH 
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Distribution Software ASSIGN Utility 


This example assumes that the floppy drive in the Winchester 
System was the boot device and that at least two partitions 
exist that are called "CPM", 


Assignments Made: 

To see what assignments have been made, the user types, 
A>ASSIGN (then presses RETURN) 

to the CP/M command mode prompt. During a terminal session, if 


we still consider the example that was given above, ASSIGN might 
respond with: 


CPM 
CPM31 


A 
B 
Remove Assignment: 


To remove a previously made assignment, the user would type: 


= 
+ erwenge mma -w o> Be mme 


A>ASSIGH X: | | ' 


Here again, "X:" is the device name, Wnen "ASSIGH" is typed, 
followed by a device name, with no other operator, ASSIGN | | 
essentially assigns that device name to "nothing", It finds no ane 
partition name with which it is to make the assignment so it eae 


then assigns the Saba device name to no Paes 


{ 

i 

| 

ee ee ee | 


ASSIGN has been restricted so that no more than two device 
assignments can be made at any given time to. pa aaa on the ——-—--—---- 
Winchester Disk System, 


The possible assignments that may be made with ASSIGN are also 
restricted. Drive A: is always the device (the Winchester disk 
drive or the floppy disk drive) that the cold boot was performed 
on. If the cold boot was performed on the 88-inch floppy in the 
ZO67 system, then B: and C: may be assigned to partitions on the 
Winchester Disk. If the cold boot was performed on the 
Winchester Disk, A: is the partition that was booted and C: is 
the 8-inch floppy device. B: may be assigned to a second 
partition if one exists, 
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mee oy p NOTE: _ The PART utility. only defines a partition } 
Oe oe oe boundaries and does not™ format the partition: A 
_-partition must, be formatted to enable it to store 
data. | If the partition is not used as the boot 
2 geviee-(where it is automatically assigned with the 
me , _Jjogical_ device name of "A:"), it will need to be 
“~ ="" "assigned so that CP/M can locate that partition, 
sogihen. the FORMAT program needs.to be run to ready 

“the partition, Once ‘a ‘partition has been formatted 
eeh-t is. ot necessary to reformat it.on any 


—c. See aise ale ae 
Se. eee subsequent - uses. If the. partition - is’ reformatted, ie 
resort: any. files on that partition will’ be erased.’ ; re 
ea e fy 
ee ne 
Femavey frets gre : . 


. * Fee gi FG 4 * ie yy ar tse 2a ee Gre Pas fee: ae eget le 
AS PR ere ea Seng tf Uy pans BOVE Sa tate Pat WO mn Ite re ei 3S 2 . ° Be Me . 5 : wT mee ae OB od ee aed 
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Distribution Software FORMAT Utility 


FORMAT " 


The FORMAT program allows you to initialize blank disks (or 
partitions) or to reinitialize used disks (or partitions) that 
contain information that you no longer need. This utility also 
performs a check on the disk media to detect imperfections on 
the recording surface, 


CAUTION: Before using the FORMAT utility, be 
certain that the disk that you plan to format does 
not contain any needed information. FORMAT will 
erase all of the tracks, including any files,.that 
are on the disk, effectively destroying those 
files. 


Ine disk must be "formatted" before it can be used for data. 
storage with your H/Z89 or H8. The FORMAT utility writes the 
necessary information on the disk to permit the computer to find 
Specific "tracks" and "sectors" where data are stored. In the 
process, it erases any information that may have been previously 
recorded on the disk. This eresure permits you to reuse disks. 


An 8-inch disk or a soft-seectored disk used with the Z37 may be 
formatted in several ways depending on the number of sides of ae. a 
the disk to be used and the density at which the data is to GF 
recorded. Density refers to how close together the data is 
recordea on the disk. Single density is the normal spacing of _._ idan, 
“——"——““the data bits on the disk. Double density refers to the fact 
jn 4 that the data bits are almost twice as close together so that 
nearly twice as much information can be recorded on a disk. 
This requires a better quality disk which is certified to be 
-Capable of double density recording. Extended density allows 
' the user to store a maximum amount of data on the disk. Some 
disks are capable of storing data on both sides of the media. 
If an 88-inch, double-sided disk is placed in the drive, both 
sides will automatically be used. FORMAT will prompt for both 
density and number of sides on a 5.25-inch soft-sectored disk. 


To use the FORMAT program, type FORMAT in response to the CP/M 
prompt. The utility will identify itself and ask if you are 
certain that this is the program you wish to run. It will then 
ask for the drive you wish to use to format a disk. 


Select one of your disk drives by responding with a letter from 

"As" to "Fei" ("Ac" through "E:* with the H8). Be sure to select 

--a device name that actually exits in your system. Put the 

desired disk in the selected drive, making certain to orient it 

am properly, and that the disk is not write-protected (see Appendix 
E). 
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Type X, where "X" is the deVite name that you have selected, and 
press RETURN to start the formatting operation. Wnen this 
“operation is complete,:you-will be given the option. to either 
“Format: additional: disks,:zor.return to the:.CP/M command mode. 
co: When FORMAT: is: done: reinsert the bad ee CP/M disk — it was 
removed), : and pees: RETURN. . oe Bees. cess Bi : 4, 


ri 


tt : a wy “ 


Ad 
p 
} 
nN 
’ 
) 
1 
‘. 
4 
(ry 
4 
t 
y 


The iveten will Aeuen to the CP/M prompt ("X>", where "X:" is 
the logged driveys: Coos See Sees ate ese, ae 7 
ag Ree > rs pe oe ge fae er es x a Fes ue oes . 3 ae ae : 


= & 
te SO ee me 3. ra ee XU £2 £3 e. i ae ee - % <- 


ne Sf 


Thre following exemple: tllustrates:the. précedure:. .”. 
RTENOTE:- < Tor. formatca:96:TPI-disk tn:a °Z37, . CONFIGUR 
=27-¢must =first: be set’ to-96TPI for:the drive that will 
723 e. used. See: "Disk Parameters Sub-Menu" in 

Chapter Six on page ue for more eee 


~ 


- - +4 
Jt = bod 2 a “ # re cf aH ro om - = £ - ° ~ » rd x od . w - bad 
-_ => ai ~ one » ww 28 *& -_ ~ 2 @ . ee oe es Re SS ae . St -ie e 


| 
+: Stepwise Procedure: cre Te cae ee es voasee ; : 


yer es aye et “« ~ ss Sen tes 


“1-2 Type FORMAT in response to P/M command. mode. prompt. 


- - eae - 


| ADFORMAT _— bia #8 


' Format Version 2:nn: pp? ete SE Be ney Ge HS : oe 
- This program is used to initialize a disk. 
ALL information currently on: the disk will be destroyed. 


PP ne ey 


—2--FORMAT asks” "Is. that what you want (y/n):". _ 


SP aD cece: tidewe Hh > nee o 248 COE 00et 8S 08vt 


Is that what you want? Cy7n): 


3--If there is nothing on the disk that you want, and you’ wish 
“to proceed, type Y. ee : eh ER age cs | 


Is that what you want? (y/n): Y 


teeFORMAT asks "Which drive do you wish to use for this 
operation?:", | 


Which drive do you wish to use for this operation?: 


disk that you want to format. 
- Which drive do you wish to use for this operation?:B 
-6e-If your response in step 5 is the letter name of a hard- 


sectored, 5-inch drive, ignore steps 7, 8, 9 and 103; then go 
on to step 11. 


S--Respond with the letter name of the drive that contains the 
| 


7e-If your response in step 5 is an 8-inch disk drive, FORMAT 
asks "Which Density? (Sssingle, Dsdouble, L=Extended):", 


Which density? (Sssingle, D=double, Ezextended):E 


Penn .qaQgrEeege epnenmag 
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8--Or if your response in step 5 was a soft-sectored, 5225-inch 
disk drive or the 8-inch floppy drive that accompanies’ the 
Winchester disk system, :FORMAT will ask "Which Density? 
(S=single, D=double):", 


“-Which density? (Sesingle, Dsdouble):D 


9~-If FORMAT asked you for a response to the questions in step 7 
or’ step 8, .type the letter that designates the density that 


whether the disk being used is to be single or double sided. 


7% 


Number of Sides? (lssingle, 2=sdouble):1 


T1-=FORMAT will then request that you "Put the disk you wish to 


be formatted in drive X." The "X" in this question will 
appear as the drive designation that you answered in step 5. 


Put the disk you wish to be formatted in drive B. 


i2--Insert the disk that you are going to format into the drive 
that you specified in step 5. 


13--At the same time as step 11, FORMAT will also request you to 


Put the disk you wish to be formatted in drive B, 
Press RETURN to begin. RETURN 


ie ee | 4 aePr ess R ETUR N . Fe Rae Bye oe ee Re oT eye Cae eg fete eae eee GEL ere 


15=-No prompt will appear and the drive's active light will stay 
on throughout the operation. FORMAT is formatting. 


16--FORMAT will then ask "Do you have more disks to format? 
C(y/n):" 


Do you have more disks to format? (y/n): 
17--If you want to format additional disks type y. FORMAT will 
go to step 4 and repeat the process, If you have no 


additional disks to format, type hn. 


Do you have more disks to format? (y/n): 


itd eo Mei 


18--FORMAT will then request that you "Place a bootable disk in 
drive A and press any character:", | a 


Place a bootable disk in drive A and press any character: 


“Press RETURN to begin." es pe a fate he ee 


may 
ube 
eared 


om ceeg Neen mae etme mane on 


x me . ee te a Cg ~ . ee is on “ ee es . . - be enw es ee Wee Fite AE es fae St TA ote 
Pep ON ey Oey Ser er Ser nial eo Oa ce oc - 6 went. he tas ~" wwe ~ * « we - 
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ca ee gees a ae vir cn : 
. a> Stell cr a ae qe 7 get v = “4° - 4 Se ae 5 > 


| TStFibutio—Sortware FORMAT -Utirity 


19--Press RETURR in. response. center rerere. ee er 


Bio Pere So es 2S By mye te! Foo a 
Place-a:. bootable disk in drive A and press. any Shareeen: : RETURN 


20--The. CP/M. command - mode. prompt. will reappear. FORMAT is done. 


- - td ~ _ -_ 
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Distribution Software DUP 


DUP, 


DUP 7 ‘. 


the Heath/Zenith Disk Utility Program, provides a 
convenient way to duplicate a disk or to verify that two disks 
are identical. To use it, your system must have two or more 
§.25-inch disk drives or two 8-inch drives. 


NOTE: The DUP utility will only transfer files 
between identical media. CP/M's utility PIP 
(Peripheral Interchange Program) should be used in 
any instance when files need to be transferred 
between different media, e.g., from hard-sectored 
to soft-sectored 5.25-inch disks. 


After the system has been "booted", you can use the DUP 
to duplicate the entire contents of adisk onto another disk. 
The two disks must be the same size and density. An example of 


this 


program is as follows: 
A>DUP 


Disk Utility eucerer 
Version 2onn 


utility 


You may at this point elect to "copy and verify" a disk, to 


Simply "copy" a disk without verification, 


~ two disks are identical. When done, you may exit 


Operating system by selecting the "Z" option, 


NOTE: In copying a disk, the destination disk must 


softesectored disk. A 5.25-inch hardesectored disk 
does not have to be formatted before the DUP 


Operation. 


CAUTION: The destination disk should not contain 


any useful information since in the process of 
Guplication all information previously on it will 
be erased, 


or just "verify" that _ 


to the 


: --b e formatted-if it is an 8<inch -or a ~5.25-ine hy ee aca noaeas aaa 


Continuing with the sample, select the "At Pea Ee! ay, and 
verify"; 


Source unit: A 


--.. Destination unit: B (drive name of blank digk) 


Put 


&é¢ 


source disk in drive A, 


Put destination disk in drive B, 


(drive name of disk to be copied) 


Press RETURN to begin: RETURN (Press RETURN after noe 


(Copy operation proceeds) 


Copy finished. 


(Verify operation proceeds) 


Verification Finished, 


CB 


C 


NOB a Pee ew wewe SEF Ce. FSR Pe, SERS oe cata _ is ew hn i = - - 
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NOTE: the source and destination drives for this 
operation must be different physical drives of the 
same size and density. . 


When the source and destination disks have been properly 
inserted in their respective drives, press RETURN to initiate 
the copying process. If you should decide to abort the copy 
operation, type any character other than a RETURR. If you opted 
to do a "copy and verify" operation, the "verify" will begin 
automatically after “copy" is completed. When done, be certain 
to label the destination disk, and remember to affix the 
required copyright notice to the new disk if it contains 
copyrighted Digital Research or Heath/Zenith software. 


The "verify" operation is useful in comparing a copy of a disk 
made by DUP. The "verify" operation will only check to see if 
the two disks contain identical copies of the same information 
located in the same positions (sectors) on a disk. Since 
"verify" does not utilize or understand the CP/M file system, it 
is conceivable that two disks could contain the same files, but 
perhaps in a different order (i.e., on different sectors), which 
would cause "verify" to report that they were different disks, 


When the selected operation is completed, the DUP utility will 
again prompt for a selection: 
_ Do you want to: 


A copy and verify 

B copy only 

C verify only 

Z exit to operating system 


Selection: 


Repeat the operation or type Z to exit back to the CP/M command 
mode prompt. 


te 
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on SETLP 


- - 


The SETLP utility provides the user with the ability to 
dymamically change the lineprinter port, baud rate. The baud 
rate is set initially at cold boot time to the value indicated 
by CONFIGUR. This program is included to permit the user to 
alternate between printers that are set at different baud rates, 
without reCONFIGURing-~such as when switching back and forth 
between a Diablo and an H14 or WH24. SETLP temporarily alters 
the values kept in memory but it does not affect the baud rate 
information stored on the disk. 


SETLP requires one argument, the new baud rate, which can be any 
of the following: 


75 150 - 1200 9600 

110 300 2400 | 19200 : 

134.5 600 4800 | 38400 3 

Example: ! 

! 

A>SETLP 1200 RETURN en a: 
+e ! 


H36 and the WH34 are generally set to 300 baud. For all other 
printers, refer to the manual which accompanies that printer. 


a 


=Distribution. Software | __.LIST Utility 


LIST 


Tne LIST command is used torkist one or more text files on the 
printer connected to the system, Typically, the files tnat you 
will list are the "*.,PRN" files generated by the assembler, 
BASIC programs, or simply readable text files produced by the 
editor. LIST also provides a number of optional functions, 
> ‘ineldding Peeene es: neadings, - and tab expansion. .. -_. 


ae “a> fo ol ie td orig ig —~— eee ~ - ae 
: - - = 
_- me 2 - -— . 
ane eae nk - we ~ ee Peg Nees pas > - & Se ee 
oa ~ = baad = ~~ . Pa 
le 


° Thee Porm: of? ene pe eae ‘i-s ‘similar .to-that of. oP Pes “The: “ETST 


scommand can eitner: be- sneered: in. -response Lo. tne “sy Stemi prompt 
“XY either. wictn cor. -without- carguments.-- Tn. the. latter. éase, the 
¥ LIST- ay ‘then: pre eee. for - ene. carguments. with. an, Ue", hee 


<> - - 
“a 7 nee ies - pox ad -~ pe ow 


~:Ene command : format. that. i:s- re with ‘this. utility are Cae 


ewe . eo. eo om 
— 


7 e 
~ wee rest mee 


al 


. re 


— - ~~ 2 we &e - = ~ te 
. ~~ Bayi eS ak ima” a s- - 


(v3 
f 


Pe 4 
‘ * ral - 2 


SE cat; Mee Se. 


_ A>LIST ‘filet a file? { file3...}} {parameters} 
SOF a . Dik oly! Tag Sige ee eh a A ne ae Te ee ee ee ee ee é 
sor oS Ae LIST RETURN _ | 
* filet { file2 { file3...}) Ppekasenere) 

The arguments enclosed in ue a are spetousl note however, that 

Spaces are required to separate individual files. The program 

may be terminated ty either pressing RETURR or by simultaneously 
~ holding down tne CTRL (Control) key and the “C (letter "C"), as 

a response after the prompt sil apveees (when used in the prompt 

mode). 


Tne available caemeteas are; 


[D xxxxxxxxxx] represents up to ten characters in a field that 

May be designated as a date field that will be  _ 
printed directly to the left of the page 
number. If this option is not selected, it _ 
defaults to blanks. 


{H text] represents up to sixty characters in a field 
that may be used as a header, which prints on 
the top line of each page. If this option is 

not selected, the program defaults to the 
name of the file that is being listed (e.g., 
LIST.COM). | 


[L nn] sets number of lines of user text per page, 
defaults60. L=0 turns: off pagination. 


CN) no heading line (which implies no page 
numbering). 


(T nn) tab stops every nn positions, default = 8. 


[P nn] start page numbers with nn, default=1. 


[uJ force all output to upper case, 


“boii Mae ik "wie ad < inde ibiismaiaaee alanis eles as Sena ae ee ae 


einai cilia ini a a a a 
i ac a a an Ee le 


« 
aac 
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[C nn) number of copies Of output created by this 


command line, default = 1, 


- [E) - — erases files on that command line after listing 
| them, 


‘When used in the prompt mode, all selected parameters (with the 
_ exceptions of starting page number and the erasure of files 
after Rr remain in effect until the program is exited. 


~ ~~ an Se How ~ - 


cs NOTE: ‘when used” from the command line, the CCP 
(Console Command Processor) will force the mapping 

ale. of -all heading and date information to upper case. 
(Refer to the Digital Research Documentation for 
-further details on forced upper case by the CCP.) 


Output from LIST can be aborted by typing any character on the 
console keyboard during printing. 


Sample out of the LIST Utility: 


A>LIST MEMBERS.LST [H MEMBERSHIP LIST] (D 6/30/80] 
or 


A>LIST RETURN 
PHEMBER.LST [H MEMBERSHIP LIs T] €D 6/30/80) 


siisodee Produce the following: 


MEMBERSHIP LIST 6/30/80 PAGE 1 


Jones, William : 1001 Oak Street 
itgeteas Gane ee ee Busytown, MI- 
02987 


Mauldin, Shirley 3344 Maple Road 
Whoknows, ID 
26783 


Smith, John 276 Elmwood Drive 
Anywhere, IL. 
60988 


ee eee ware nee anmene: 


- 
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eee eT OT 
FT CTT SURE PET ea 


: abtcnieaiaicicn ess eeenenmiead 


“ 
"4 


Haepeeer Gf tet es. 
£ 


Comme nc - RREL |... 


Prater fi tne 


The “Weath7 Tent eh supplied program. "PREL wili take the hex “outpat- 


files of two assemblies and generate a relocatable file. The 
first...of.the assemblies,should have.as, an origin -000H . and the. 
second.-assembly -sheuld. be -one -page,. “higher, .or O100H. |. ‘The’ hex 


output--of the- -first ragsembly should have - an "extension “of> “HXO,- 
and the hex output of the second should have ‘HX1 for fees’ " 
extension¢~- gener 


use Srce tne commenc Pigs ine Coe 
ee he ee eZ Commerc: PPOCCESES? 2. oNe  ,. SEV EE. Se : 
PREL reguires-:two- sarguments:,.the,fitst.is the primary: “name of 
the two. -:hex. files. and. the . -seoond is thé primary. name “of the 
output page. relocatable, Fite. ..-The.output file. will. .have the 
extension PRE. For example the command line: ”* 
att . ie ’ . She slge, 3 : 


7.7 , 
Sf > 
oe te 


“AD PREL. MYPROG TESTPROG.. 


would- create the -file. TESTPROG, PRE from the two hex files 


- SS © © we « 


eee a ea oe a or of ty bd 


roe etter mee 


PREL- will "compare ae Te. nee files and So peor two separate 


a™ functions. The first of these is to conver*® the hex file to a 

‘¢ binary file similar to the function-of the LOAD . transient. In 
ALY addition it appends a relocation table to the end of the file 
which includes a bit for each byte in the module. If a 


_—_-__particular-.-bit—-is -.a—one,--it-means that--the- value--of---the-—--—-—-—-_- 
associated byte must be relocated when. the program is loaded 
into memory. An error message will result if the hex values for 
a given byte differ by other than 0.or-1.. An error message will 

also result if the addresses in the hex files are not in. _ 
numerical order. | 


~All addresses that need to. be relocated should be expressed 
relative to the bas2 of the module and not defined absolutely. 
A convenient way to do this is to not put any "org" statements. 
in your program and then use batched commands in a Submit file 
that actually does the required. assemblies and the conversion to 
a relocatable format. An .example of this type of batched 
command might be: fie | 


PIP TEMPO.ASM=ORGO.ASM,$1. ASM 
ASM TEMPO.AAZ 
REN $1.HXO=TEMPO.HEX 
ERA TEMPO.ASM 
PIP TEMP1.ASM=ORG1.ASM,$1.ASM 
ASM TEMP1.AAZ " 
ERA TEMP1.ASM 
REN $1.HX1=TEMP1.HEX 
ae PREL $1 $1 

ERA $1.HXO 

ERA $1.HX1 


where the files ORGO.ASM and ORG1.ASM contain only the 
statements “org OOOOH" and “org O100H" respectively. 
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You could invoke this command sequence by typing: 
SUBMIT MAKEPRE HYPROG 


where the above command sequence is contained in a file called 
MAKEPRE.SUB, the original assembly file is called MYPROG.ASM and 
the final result is a page relocatable file called MYPROG.PRE. 


NOTE: This type of program relocation occurs 
during the MAKEBIOS utility operation. During 
MAKEBIOS operation, the relocation commands for the 
two offset files appear on the terminal. 


— 
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CHAPTER THREE: HAKEBIOS UTILITY OPERATION 


) The Basic Description of MAKEBIOS Functions. 
© Precautionary Rotes for the Use of MAKEBIOS. 
@ The Basic Operation to Create a Hew BIOS. 
© How to Implement the Newly Created BIOS. 


The CP/M Basic Input/Output System (BIOS) must provide routines 
for the Input/Output operations for any peripheral devices that 
are connected to the Heath/Zenith Computer. Among these devices 
may be the disk drives, keyboard, a video terminal and a 
printer. 


Because Heath/Zenith computers may be configured to use a large 
variety and combination of different types of disk drives, 
extensive modifications to the original Digital Research BIOS 
were necessary to operate efficiently with each type and 


“combination. MAKEBIOS is the utility program that allows the 


user the ability to customize a system with the drives that may 
best handle a user's particular needs. The Distribution Disk 
(or Disk-Set) that you have purchased comes with a minimally 


-configured BIOS that handles a basic system, appropriate for-the 


type of media on which it was supplied. If at any time you 


‘decide to add disk drives to your system, MAKEBIOS is essential 


to build a BIOS that will allow the use of the drives that you 
might choose. 


A single BIOS that could handle everyone's needs would not be 
memory effective, the BIOS would be too large and would require 
ailarge amount of memory for a minimum system. MAKEBIOS 18 a 
batch program that is submitted using the Submit command, 
MAKEBIOS relies heavily on some of the basic functions of the 
CP/M operating system, and some special programs designed by 
Heath/Zenith's software engineers. 


-MAKEBIOS Utility Operation Precautionary Notes 


Se 


section One: Precautionary Notes: 


MAKEBIOS is a self-modifying program that requests the specific 
disk system combinations that are being used in the system, and 
then appends the necessary routines to itself while dropping all 
of the unnecessary routines. Because of the very complex nature 
of the program and because it is self-modifying, the user needs 
to observe three cautions faithfully! 


that backup copies of disks are essential. 


know that the changes have.been made. but. it. will... ----——-. | 


CAUTION ONE; 


Before running MAKEBIOS, make a backup copy of the 
complete distribution disk and keep the original in 


a very safe place. Always use the backup copy in | 
any operations. — 
CAUTION TWO: | 7 _ ' 
MAKEBIOS modifies the source program BIOS.ASM, 

located on the Distribution Disk. The source code | 
consists of a main body and a preamble. Changing 


the order of the preamble portion of the program or 
its initial values can easily render that source fs 
program . totally useless, which is another reason © CS. 


bars ‘ 
+ alee 


Because the program is self-modifying, it expects > UT 
certain values to be in precise places, If the 
arrangement oof the code is altered, or if any of 
the values have been changed, MAKEBIOS will not 


‘ 
OR ae. ee SP yeTET EEE -rrTS Cuemepe of 


alter the program anyway. 
CAUTION THREE: 


Some care needs to be taken during a transfer of 
the MAKEBIOS program (and the associated programs 
that MAKEBIOS uses) to other disks. MAKEBIOS calls 
other programs from disk, and if a particular 
program is not present on the correct disk, 
MAKEBIOS may execute incorrectly or cause the 
System to run endlessly, making it necessary to 
reboot. This could waste valuable time, and cause 
frustration because the program: would have to” run 
again with all of the programs resident on the 
correct disk. The user should not attempt to copy 
MAKEBIOS to another disk unless the user copies all 
of the associated files to that new disk.. 
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ba 


pacino GO Aleem Rid cc Malia lage, eR gs Rte ce Re Mi ol 


To begin operation of the-MAKEBIOS program, type in SUBMIT 
MAKEBIOS, followed by the drive name where you want to store the 
new BIOS (details on Submit may be found in the Digital Research 
Manuals). - The format of the command would be: 


“A>SUBMIT {Y:} MAKEBIOS {X:{Filename} } {Y:} 


Here, the "X:" is the optional destination drive name, where the 
new BIOS is to be sent when completed. If no drive is specified, 
the currently logged drive is assumed (in the case above "A" is 
the logged drive and is- shown» “by the Prompe mA>M™), 


NOTE: The SUBMIT program must be Leceesa on the 
disk in drive A. 


"Filename" is an optional name given to the new BIOS so that it 
does not overwrite a previously existing BIOS that might already 
be resident on the destination drive. This type of overwrite 
could be catastrophic if the destination were specified as the 
drive where the only copy of the original BIOS is located. 


The "y:" is the optional source drive name for the BIOS (and 
where MAKEBIOS.SUB must be resident) that is to be used for this 
operation, ae 

NOTE: At least one space must be inserted between 
each of the parameters typed on the command line. 


NOTE: If your Distribution Disk Set is on 5,25— 0 --- + [3m 


inch media, MAKEBIOS should be run with VOL. I in 
A:, VOL. III in B: and the destination disk for — 
the new BIOS in C:. Then use the following | 
command: ; 


AD>SUBHIT B:MAKEBIOS C: B: 


+ om oem 


a] 


rae 


‘ om. 


Reem nae 6 0 teal Aarti teten man bomeh  <apapeiten aetna | 


oe oo 


oD 8k eae deete feee.--weiemnes -~ meee we ow OMe! 


S 


: 
| 
| 
| 
| 
| 


KONE. 


“SOId MBG ayy pazxaTdwoo sey weuBoud SOIGANVH PUL 


ALA TdWOO NOTLONAA SOIGAAVH 


(*3uTHsOM 


S9TtuM *AeTaIp Buoy) 


aTtym ‘Aetap gu07) 


¢ “spuodsau Aasn au. 


. Te yun asned. Tttm 


7-2 € SOIPANVH<Y 
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jem .MAKEBIOS Utility Operation MAKEBIOS Operation 


’ 
‘ f . oe aa ee s = is o = . ane ut uae ” ‘ 
pik sie Ree te - - - : Ste ee Werte 
A TTS TIC It rere or. ++ oie Arnage an ee SEE EE : Se aenteas ves ceee 
o os, 
co” 


The new BIOS may be transported via PIP (with the noR option 
eit the: BIOS has been set as $SYS and -$R/O with STAT) to other 
“disks if: ‘desired. -If these two options are set, typing 


eens AK: TBIOS, 2 STS ___ RETURN ea 
arte ee Aer ; ee eee F370 = 
where "Xi" is the oP eye shee the BIOS.SYS file’ is TOCENES will 
display Shot. 
RECS* -BYTES - “EXT “ACC =" 


KQ- 6K 1 R/O A:(BIOS.SYS) 

BYTES ' "REMAINING ON Az: nnk 
The "R/O" Si gnifies that the file is set to Read/Only status, 
and the parentheses. around the filename, (BIOS.SYS), indicate 
that thé “file is: set to $SYS (System File). ; 


As an example of a R/O and SYS file transfer, use PIP like this: 
A>PIP B;=C:BIOS.SYS[R] 

This example assumes that you are logged on drive "As" (A>) and 

that PIP.COM was on the disk in-that drive. It also asSumMes 


Wy that the BIOS.SYS location is on drive "C:" and that you are 
- copying it to drive "B:", 


-+---—After-the-new BIOS is-on the disk that-you wanted to transfer it~ 
; to, use STAT to set the BIOS.SYS to Read Only (R/0) and to 
System (SYS) by typing, 


sty, CO STN Occ Fa ee eg ee, ee Deen 
ADSSTAT BsBIOS.SYS $SYS 


to set the appropriate indicators. Here, “B:* should te the 
name of the drive where the unprotected BIOS is located. 
Additional details are on pages 5 and 6 of the Digital Research 
manual, "CP/M 2.0 User's Guide For CP/M 1.4 Owners", and in "An 
Introduction to CP/M Features and Facilities" on page 14. 


Sunn. 


—s 


~ Page 58 


jo~ HAKEBIOS Utility Operation Implementing the New BIOS 


Section Three: Implementing the Hew BIOS 


There are several steps that must be performed after the new 
BIOS has been created with MAKEBIOS to utilize that new BIOS. 
The basic outline of these steps would be: 


- - @ Create a new BIOS with MAKEBIOS. 


6 Use MOVCPMnn to properly configure the operating system 
“with the newly created BIOS and memory size for the 
hardware where it will run. 


“ tw. -* * 


@ Place the newly configured operating system on the 
system tracks of the disk to be used with SYSGEN. 


e@ Put a copy of the newly created BIOS.SYS on the disk if 
it is to be a bootable disk. 


NOTE: After a new BIOS nas been created with 
MAKEBIOS, it is extremely important to name the 
BIOS descriptor when MOVCPMnn is used. The new 
BIOS is not resident in memory after MAKEBIOS is 
run, The new BIOS is located where MAKEBIOS was 
requested to place it (or on the disk in Drive A: 
if no destination drive was specified). The new 
BIOS must also be renamed to "BIOS.SYS" if the 


MAKE BIOS— option was-used-to create the BIOS under n— 


an optional filename. 


An example of the total operation for BIOS generation and. 
implementation, including MAKEBIOS, MOVCPMnn_and. SYSGEN is. shown —_ 


__ below. This example might be performed on the following 
hardware configuration: 


A H/Z89 or an H8 Computer 

64K of RAM (Random Access Memory) 
One H/Z4HT7 : 
One H/Z17 


®e ec 


A>SUBHIT HMAKEBIOS B:NEWBIOS RETURNW (Command input by 


user. Submit and 
MAKEBIOS are 
located on drive 
WAST, The new 


BIOS, “NEWBIOS", is 
to be sent to drive 
"Bst ) 


A>MAKEBIOS 1 B:NEWBIOS (Phase One of MAKEBIOS begins) 


a Ee A RT EN oe NRT AEE ENNT OE ERAS CS CURE 9 BA ee Oe OG! OS -SEEERED “en Qremn GybmOnysepEEEEPEEEET 8s 
4 


Pe” i Fe FO PE LE LILY ELS ELLE DUT A OS Fn Ey Oe Oe I 


MAKEBIOS Utility Operation 


~~ HIT 
~~ H37 
~- HAT 
~- H67 
H17 
~- HIT 
-~- H17 
~- H37 
-- 437 
~- HUT 


mM COMM oO}O > 
t 
' 


BIOS SELECTION MENU 


ONLY 
ONLY 
ONLY 
ONLY 
AND H37 
AND H47 
AND H67 
AND H47 
AND H67 
AND H67 


ENTER SELECTION: F 


A>ASM BIOS.AAZ 


CP/M ASSEMBLER = VER 2.0. 


1560 
O2EH USE 


FACTOR 


END OF ASSEMBLY 


AOREN BIOS. HXO=BIOS.HEX 


A>MAKEBIOS 2 B:NEWBIOS 


A>ASHM BIOS.AAZ 


CP/M ASSEMBLER - VER 2.0 


ome T660 


O2EH USE 


FACTOR 


END OF ASSEMBLY 


wo --.—A>REN BIOS. HX1=BI0OS.HEX 
A>PREL BIOS B:NEWBIOS 


A>MAKEBIOS 3 B:NEWBIOS 


MAKEBIOS FUNCTION COMPLETE 


A>HOVCPEHAT 64 BsHEWBIOS 


MOVCPM47 


VER 2.2.03 
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Implementing the New BIOS 


(User chooses a 


BIOS for the 


H/Z17 and H/Z47 disk drives.) 


(Page Zero Ass 


(Hex File rename 
(Phase Two begin 


(Page One Assem 


(Second Hex File 
(PREL locates B 
and HX1 extensio 
a relocation 
addresses.) 


(Phase Three beg 


(NEWBTOS is now 
drive "B:".) 


(Make system fo 
configured for 6 
the BIOS called 
drive Bs:",) 


(MOVCPM47 begins 


CONSTRUCTING 64K CP/M vers 2.2 (States siz 
READY FOR "SYSGEN" OR 


MSAVE 38 


CPM64.COM" 


(The new 
in memory.) 


embly begins) 


d HXO.) 
S.) 


bly begins.) 


renamed to HX1.) 
IOS with HXxO 
ns, and builds 
table of the 


ins.) 
resident on 
r H/Z47 disk, 
UK RAM, using 
"NEWBIOS" on 
cD 


e requested.) 
ovstem is ready 


OS Ne CT GT: = * Toe een ene orn vere emer arg REY et I ERLE, PA COPY AEE SORES EDISON PREDATES TEI T AT REED SNE TES NR TNS SEITE OE | nh AIO 
r « 
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A>SYSGEN 


SYSGEN VER 2.2.03 


SOURCE DRIVE NAME (OR RETURN TO 


DESTINATION DRIVE NAME (OR RETURN TO REBOOT):B 


MAKEBIOS Utility Operation 


Implementing the New BIOS 


(User calls system generator.) 


(SYSGEN begins.) 


SKIP: RETURN (User 
presses RETURN because MOVCPM 
placed the newly sized system 
in memory.) 

(User 
requests that the new system 
be written to the system 


tracks of the disk in the "B:" 
drive.) ' 


DESTINATION ON B, THEN TYPE RETURN RETURN (Yes, 
"B:" is the destination drive. 
User presses RETURN.) 
FUNCTION COMPLETE (New system is written to 
system tracks of disk in drive 
se) = Rea 
(User 


am | DESTINATION DRIVE NAME (OR: RETURN TO REBOOT): RETURN 


fn Ae ce ae a mm ee a te ern cree = 


“ADREN BesBIOS.SYSsB:NEWBIOS | 
A>STAT B:BIOS.SYS $R/0 


AOSTAT BsBIOS.SYS $SY¥S 


A> 


‘user only makes one 


may want to continue here by 
inserting another formatted 
H/ZHY7 disk into a drive’ and 
name, In the example, the 
bootable 
disk.) 


(New BIOS is named to BIOS.SYS 
the BIOS Loeder can .. 


SO that 
tocate the file.) 
(BIOS.SYS is set for Rerd 


Only.) 


(BIOS.SY¥S is set as 
File.) 
(CP/i awaits next command.) 


system 


typing in--an appropriate drive-—-----~ 


aque ae pre ee wee we ot ees ee: 
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CHAPTER FOUR: USING MOVCPH AND SYSGEN 


QF gr Pe eee SS a, See ~#. - - -— ~ ee 
on 3 TO Be ata ; aie! ££ a a nl é bala pr = : Se ee =x. “2 ag . 
Se & i Bee Se Sales a a Se eee eo it =e ie Gee tT rw Plus : 
RIE ELE AT ALI ED LTTE IOS “ 


Soe) oe eee Stools geese 
Sees Wo ee ee eee ee Ea oe 
TT eS Se; a sch eT 
© The Basic Description o of “MOVCPHnn and “SYSGEN. 
e...-~-The Operation , ,of -SYSGER.-... Se oles 
° How to Operate MOVCPHnn, "and ‘the Options that (°° °) 
are Available. Cee ee sete ea! os ee tke 
: rr 


reo WO B- - arcs - er 


The FORMAT ‘utility prepares g “disk. so that it may be used tO 
store recorded data but it does not enable the disk to be 
booted. FORMAT creates a magnetic map on the disks surface so 
that the operating. system is able to distinguish different 
Locations on the disk where data may be Stored. ‘These locations 
are called tracks and sectors... Tracks are closely spaced 
magnetic rings that run parallel.to the- outer. edge of the disk; 
they are much like the grooves in a record but they form a 
complete circle and not a Spiral, Sectors are magnetic 
subdivisions of tracks. 


oom" “SYSGEN, the system generating utility, writes the disk. 
Operating system to specifically allocated tracks on the disk. 
These allocated tracks are the "System Tracks" and are iocated 
along the outer circumference of the disk's recording surface. 

The -.disk operating system contains the additional routines that 
are required by the monitor ROM so that on a boot, the operating 
System can place the necessary operating system routines and. 
BIOS (provided that it is also located on the disk) where they 
can perform all of the necessary functions in memory. (Chapter 
Seven on pageio8 contains additional details about the 
interaction between the system tracks and BIOS). 


MOVCPM is a utility that adjusts the operating system to use 
different memory sizes. This release of CP/M is initially 
configured for a 32K memory. Using MOVCPM will create an image 
of the operating system that may utilize the full amount of 
memory which is available in the system. When MOVCPM has 
completed its operations, it has stored an image of the 
operating system in memory at a location known to the operating 
System. It is from this known location in memory that SYSGEN 
copies the system image and writes it to the system tracks on 
the disk. 


-~?” 


28 ea ee em Re: ene emeee Eee: care, 4s mene oma: or Pe 


ED mtg sae, me 


Page 62 


Using MOVCPM and SYSGEN Basic Description 


NOTE: When MOVCPMnn is to be performed with a BIOS 
created by the MAKEBIOS utility, both {memory size} 
and {BIOS descriptor} must be specified. This is 
because a BIOS created by MAKEBIOS is not in memory 
and MOVCPMnn needs to be told which disk drive 
contains the new BIOS. 


ge Using MOVCPM and SYSGEN 


Prod 


i 


There are four MOVCPM programs and each of them allows the 


a 


Section One: NOVCPHnn 


is 


MOVCPMnn Utility 


user 


to reconfigure the CP/M system to a particular memory size for a 


particular type of disk drive. 
CP/M will run in as little as 32K or as much as 64K. 
different versions of the program operate identically, 


of 


The Heath/Zenith implementation 


The 
with 


MOVCPMnn used to size the operating system to match the required 


memory and make bootable disks, where "nn" is the type of 


controller that will read the disk when booted. 


Boot-Device controller. designation: nn 


The basic command format is: 


MOVCPHnn {memory size} {BIOS descriptor} 


disk 


MOVCPM17 for the H/2Z17 controller (5.25-inch hard-sectored) 
MOVCPM37 for the Z37 controller (5.25-inch soft-sectored) 
MOVCPMH7 for the H/Z47 controller (8-inch floppy) 
MOVCPM67 for the Z67 controller (Winchester Disk System) 


Wwe yty, 


One parameter, "{memory size}", sets the size of the desired 


system in multiples of 1024 (K) bytes. 
“W{BIOS descriptor}", 
--.- £0 be used for the operation. 


The second parameter, 
specifies the location of the BIOS that 1S000 00 07 
If no parameters are given, 


MOVCPMnn will automatically configure the system for the maximum 
memory size found by a hardware exploration of the machine and 


use the BIOS that is currently resident in memory. 


If the "BIOS 


descriptor" parameter is omitted, CP/M will use the BIOS that is 
currently loaded in memory. 


NOTE: After a new BIOS has been created with 
MAKEBIOS, it is extremely important to name the 
BIOS descriptor when MOVCPMnn is used. The new 
BIOS is not placed in memory after MAKEBIOS is run. 
The new BIOS is located where MAKEBIOS was 
requested to place it. The new BIOS must also be 
renamed to "BIOS.SYS" if the MAKEBIOS option was 
used to create the BIOS under a filename other than 
"BIOS .SYS"s . 
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MOVCPMnn permits two optional parameters (designated here by _ 
those fields enclosed between the left and right braces, 
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Using MOVCPM and SYSGEN | -  MOVCPMnn Utility 


eae 
wr. 


= 


Le mae A eT eee rd oe nee een 6 


ee Re ee enn ae A ee we eee ee ee ee 


The options that are available for each of the two parameters 
are as follows: 


Wd 
i nT a hee 


Syntax: MOVCPMnn {memory size} “{BTOS descriptor} 


Memory Size tenn kennly {memory size) ; 


~-— ty ~ ~ 
me ee: FS oom ~_ be ~ 2 ~ ea 


wo. KX fan integer expressing the size in “kilobytes (multiples 


. - : 

~~ 22, * ~ baal 
zs nm -~ 2 

m%? 


ore.-,-* sa, hardware explorseian is performed and uses the total 
Pi ieee quantity. o f. memory. it finds. connected and available. 


Ae eke cs no specification. is made (null), MCVCPMnn treats it 
as it would an asterisk (*), 


“NOTE: If (the {BIOS descriptor} parameter is 
specified, MOVCPMnn requires that an asterisk (#) 
Or an integer (nn) parameter is specified. 


BIOS descriptor (optional): {BIOS descriptor} 


* suses BIOS currently resident in memory. 


null sif no specification is made, MOVCPMnn uses’ the 
current BIOS in memory. 


‘wee 


TTX ES EMOVCPHN UWwill” use the BIOS.SYS found on drive 
i designated by "xX", 


X:filename =MOVCPMnn uses "filename" on drive "X" as is BIOS 
iets SO Saag teh eB enh Oa ia es source. «=. ee ee weet ak eS ne eas BEE EP eerste ge ta es gt 


NOTE: If the {BIOS deseriptor} parameter is 
specified, MOVCPHnn requires that a {memory size} 
parameter is also specified. 


Some examples of MOVCPMnn are: 


A>HOVCPH6T 64 # (bootable from Z67 controlled drive, 

: for 64K using the BIOS currently in 
memory). 

A>MOVCPH37 ® C: (bootable from a 237 controlled 


drive, for the amount of memory 
ae _ found in a hardware exploration, 
uSing the file C:BIOS.SYS), 


A>HOVCPHI7T 32 B2eHYBIOS (bootable from H/Z17 controlled 4 
| drive, for 32K memory, using a C 
file called "MYBIOS", an / 


ontionally named BIOS created 
with MAKEBIOS, as the BIOS). 


a EERE A care Re 


ye a 
ee TF ~ 
ep ee - 

a oa sae 


wo 


SaieS hg™MOVCPM< and’ SYSGEN 


NOTE: “MOVCPMhn'may be used'to‘configure'a disk fer 
less’ memory than is actually present in the system 
but if the disk is set for more than is currently 


“in the system.” you ‘will not be’ able ‘to boot the 
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System at a pre-determined location in memory, and a RETURE. 


Using HOVCPH cand GEE 
es 2 S.2 oe a ees ie, elas 


gmoney \ PPE ERIE re~ FE Oe one - 


SYSGEN Utility 


pect2on auc eee 
LOS SOS eS eS “. 
SYSGEN. permits. the. user. te. wee the portion of the operating 
System:that pertains specifically to the disk operations on the 
System_tracks of a disk. It. will-.also permit COPYING a system 
from the:-system tracks of one disk to the system tracks of 
another disk. When used to put a system created by MOVCPMnn 
onto the system tracks of a disk, run the SYSGEN program as 
follows: 


A>SYSGER 
SYSGEN VER 2.2.03 | 
SOURCE DRIVE NAME (OR RETURN TO SKIP) 


When asked for the SOURCE DRIVE, press RETUREB. No source is 
necessary in this particular case because MOVCPMnn left the 


causes the program to use what it finds at that particular 
memory location as the source from which it is to generate a 
System. (See: "MOVCPHnn" for further details.) 
SYSGEN will then prompt with, 

DESTINATION DRIVE NAME (OR RETURN TO REBOOT) 


Place the desired destination disk in a drive, type the letter 
indicating that drive, and then press RETURN. SYSGEN will 


Drive. If you wish to put the system on additional disks, you 
may repeatedly select destination disks. If you do not want to 
SYSGEN additional disks, press RETURN to the above prompt. 


“If the system that you wish to copy is on a disk (as opposed to. 


- being in memory) you will need to read the system in from that 


disk. The procedures are the same except that you answer the 
prompt, 


SOURCE DRIVE NAME (OR RETURN TO SKIP) 


with a valid drive name. The system will then be read into 
memory at the sysgen location. After the system is read from 
the disk, sysgen will offer you the option of automatically 
copying BIOS.SYS from source disk to the destination. The 
prompt 


COPY BIOS.SYS (Y/N): 


is displayed at the terminal. If you type "Y", BIOS.SYS will be 


SNe 


copied from the source disk. If BIOS.SYS is not present on the 
disk, an error message will be displayed and SYSGEN will 
continue, If your response to the prompt is "N", the automatic 
copying of BIOS.SYS is skipped. Writing the system to 
destination disks follows the same procedures given above, 


You will find it worthwhile to examine the interaction of the 
MAKEBIOS, MOVCPMnn, SYSGEN, Save, and DDT utilities. For more 


4 nlawewmati ann anm ¢hn APD Ls 9D KTR AT RWEDAFrTAR MIITnEet 


__ complete the write operation and again prompt. for a Destination —~——.—-.- 


ee epee 
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oe a “Beginning ‘the Backup/Restore Program 
eu. 0 een Operation: fr ‘om: Hain, “Menu: -and Prigary 
SS e + Optionse::: cf ¢€ Lik: ee, es Ge 
a ee 
How to Change the Logged Date 
Breve mr: ; 
PF a gpg Wa: 
=e: <2! Creation. of a Files and Secondary Options 
ae eae ee aa Soe Rn, Geet Pid - é = Pac : 
te oe we ek he tee! eb AS !. és aap eet er 
) The Restoration of Files 
ere T on oe Oo Soe Coe ee, See eS 
ye Serene "Comparing Twe - Identical ‘Files: for Accuracy 
a ee ee wee Tt a 22s oS moots : 
$ 
a es “Listing the Directory. ofa Backup Disk or Disk , 
Pig Hos 


- ' - ~- ee - v - 
‘= bd — ” a - — - 


Set = 


-"-The Backup and Restore program is designed only for use with the 
Z67 Winchester Disk System. (If you do not have a Z67 
Winchester -Disk System, skip over’ this Chapter and read Chapter 
Six.) This program allows the user to create backup copies of 

'. any ‘Winchester disk. files by putting those files onto floppy , 
disks. It also allows the backup copies to be written back onto 


aoe Che Winchester.disk.. 


ne te ee ne tree i en a a ee eee ee i eee ne + a ee eee 


: | 
The operations of Backup and of Restore are methods for 
transferring files. The names of these two operations describe 

the direction in which the file transfer takes place. Backup 
“transfers the files from Winchester disk onto floppy disk. 

Restore transfers them from the floppy backup medium to the. 
Winchester disk. . 


This program is ultimately limited to an 8 Megabyte file size 
(the maximum CP/M supportable size for the Winchester disk), and 
it may be used with either random or sequential files. Each 
backup disk that is created will contain both a volume number 
and a date of creation written to the disks as filenames, even 
though they contain no file. This distinguishes one backup disk 
from another. 


This utility is able to work with files that are larger than the 
medium where they are to be stored because it provides a method 
of storage that allows a file to exist laterally over several 
floppy disks. This method creates a separate directory that is 
located on the first disk that is created during each backup 


fens operation. 


This directory provides the means for this 


program 


to handle files 


that extend across several disks. 


The directory 


keeps track of which volume number(s) a file nas veen stored on. 


f 
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Section One: Beginning Operation 
invoking the Program: 


On the system disk the file for the Backup and Restore program 


is listed on the directory as BRS.COM. To invoke the file for 
operation you would type in BRS and press RETURN while at the 
CP/M command mode prompt. This appears as: 


ADBRSte we SH ert ‘(then press? RETURN) 
When BRS.COM. is -invoked, the- program will cause this, 


« Z67 Winchester Disk Backup/Restore System (BRS) 


Release Ver, 1.0 | Copyright (C) July 1981 


Heath/Zenith Data Systems 


Enter Today's Date. (MM/DD/YY)  s2=22=> 


to appear on the monitor. 


Today's Dates 


The first aromee that will occur when you invoke BRS is an 
enquiry for the current date. This date enquiry is to allow the 
System to keep track of the date that a backup was made, The 


Enter Today's Date. (MM/DD/YY) soae> 


The program requires a date to keep a record of when the Backup 
Operation was performed, That date allows the system to 
differentiate between disk sets, and provides an orderly method 
of filing different backup copies containg the same files. 
Chronological files may be kept by the user in this manner. 


The date that the user enters is checked to ensure that all 
characters are numeric (other than the "/"'s), that the month is 
less than 13 and that the day is less than 32, 


_. if the date that is input is the wrong date (either you meant to 
put in another date or used, for example, yesterday's date by 

——» Mistake), the date may be changed from the menu that will appear 
(Samy during BRS Operation. 


NOTE: The date prompt requires two digits in the 
year column, the month and day columns do not. 
Also, for the creation of special files, zeros (00) 
are permissible as a day, month, or year. 


ae a 
Cj 
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Invalid Dates: 


Some examples of invalid dates would be: 


s222>12-10-82 (will not accept hyphens) 
 ses2>7\8\93 (invalid field seperator) 
2222>18/3/78 (the month column exceeds 12 


months. No European style dates.) 
s222>12/32/99 (the day column exceeds 31 days.) 
Date Errors; 


When an invalid date format has been entered, tne program 
announces, . 


Syntax Error 
and prompts again for the correct date. When the date given is 
outside of the parameters allowed for in each column, the 


program responds with, 


Invalid Date Entered 


and the prompt is repeated. 


“Disk Drive Specification: 


After the date prompt has been properly answered, the program 
will ask what the device names are for the disk drives being 
““yused., The first device prompt will appear: eh nn 


Enter Winchester Disk Drive Spec. (A:=-P:) s=ss=5> 
Here, the user is to enter the device name of the Winchester 
disk, or the partition on the Winchester disk where the user 
wants to perform file operations. 
An example of a correct device specification would be: 
Enter Winchester Disk Drive Spec. (At=P:) szz22s>A RETURR 
This prompt recognizes only the first,character that is entered. 


A user response of A or As: i8 acceptable as the device or 
partition named "“A:", 


.-¢ 


On receipt of a valid response from the user, the program 
continues with the next prompt: 


Enter Floppy Disk Drive Spec. (A:—-P:) sss7 


. 
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The response by the user to this prompt must meet the same 
Qualifications that the prompt for the Winchester disk 
Specification required. An example of a correct entry would be: 


Enter Floppy Disk Drive Spec. (A:-P:) ==s=>C RETURN 


Drive Specification Errors: 


If the user inputs an invalid device name, such as "Q:" Conly 
device names A: through P: are acceptable), the program informs 
the user of the error with: 

Invalid Drive Specification 
The program then prompts again for a correct device name. 
If the user selects a valid device name that is valid but is not 
currently assigned to the Winchester or Floppy Disk Drives in 


the Z67,the following message will be.displayed: 


Drive not Available in Current Configuration 


we 
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Section Twos: Master Henu Operation 


The rest of this chapter will cover all of the operations that 
may be accessed from the menu. Each operation will be discussed 
in the order that it appears on the menu. If particular options 
are associated with an operation, these options will be 
explained at the point that their selection may occur, The 
primary options are also given a full desert ptron under "Master 
Menu Options" section, below. , 


Ending the Programs 


At any ‘noone during the course of this program, pressing CTRL 

and C simultaneously will exit BRS and return you to the CP/M 
command mode. Also, in response to the prompt at the Master 

Menu, you may type in the character "E" (for EXIT to CP/M) and , 
press RETURN. 


If the initial boot was performed from the floppy disk in the 
Winchester Disk System, when "E" is entered from the master 
menu, BRS will request: | 


Place a Bootable Disk in Drive A: 


Enter Carriage Return When Ready 


ee ee eee ee er a NE AS  -  S  E O  N O  S E  S RSS 
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The Master Henus 


ou. All operations and transactions begin and end at this menu. The. 
) operations and options that are displayed by the Master Menu 
are: | _. 


BACKUP AND RESTORE MASTER MENU 


on GD? > OF C® CD &® CO EE OB E® ED OD > > & OF GD OD OF OF © E® OD AD CD Gp aD OP Ow CDP EF E> a EE OD OD Ow o® CD OO a 


D DATE Change 

B BACKUP Creation 
R RESTORE Files 

C COMPARE Files 

L LIST Directory 
E EXIT to CP/¥ 


OPTIONS: Valid Only on BACKUP(B) and RESTORE (R) Operations 


Verify all files after writing. (B/R) 
Disable karning messages. (B/R) 

Allow R/O Files For Restore. (B/R) 
File Deletion after saving. (8B) 
Prompt for all actions. (B/R) 


vir as 
7 


Select Operation (X /Y/Y/Y) sos? 


Th e Backup/Restore system Operation 


Haster Menu Options: 
The prompt that is displayed at the bottom of the menu, 
Select Operation (X /Y/Y/Y) =<=S<> 


has several options available, where the "X" is an operation 


code and eon "/Y¥" is a oN on. 


NOTE: No spaces se eare be inserted between an 
Operation and a switch, or between switches, 


Any of the operations may be performed without options by typing 
one of the seven, character codes ("D", "BM, "RH, wcn, mEM of 
"E") and then pressing RETURN, The command format is 


represented in the prompt by the "X" (shown within the 


pe emreeee Only one operation may be selected at any one 
time.. 


Five options may be utilized in the form of switches ("/y", 
"/W", "A/S", "/F", or "/P"), as shown by the "/Y" in the prompt's 
parentheses. These switches are the primary options that are 
available for option selection from the main menu, and would be 
entered direc .ly after the Backup or Restore command codes. 
These options may only be used with the Backup and Restore 
commands. The parentheses to the right of the option list shows 


the key character of the operations that they may be~used with,” 


(See: "BACKUP CREATION" and "RESTORE FILES" for an explanation 
of the option usage.) Multiple switches may be used with the 
appropriate Operation, 


An example of the Restore operation with the applicable, primary 
switches might be: 


Select Operation (X /Y/Y/Y) szez=>Restore/¥/P 


It is not necesSSary to fully type "Restore", When the first 
character of an operation is typed, the command word is 
automatically completed, Upon typing the "RB", the program will 
immediately display the "estore", Tne two switches entered, 
"/¥" and "/P", signify that the program should Verify ("*/V") the 
restored files to ensure that the copies are identical to the 
source, and that the program must es ("/P") the user before 
it performs any action, 


An invalid selection to this prompt will cause the system to 


ae dn. 


report a syntax error and redisplay the selection prompt. 


CP 
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“= ‘Section Three: *Date- Change ~ 
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*The* first: operation: Listéd én the menu “is “Date -Cnange". This 
operation is handled much-like the first prompt that appears and 
requests the gOR EL eae The Same- format. TOY date entry 1s 


r = 


wr © &€ | ww 


entry “is See eer eee s “Date*, above6n page 68.) 


* The date’ operation’ allows “the “date ‘to ‘be ‘changed -that was input 
, during the ‘initial prompt, . “in, ‘case that: date Was” incorrect. fhe 
"Tor, it” to distinguish ‘between different disks that may have 
"Files with identical namés on‘them. ‘The date also allows a 
~ method to determine which backup disk was the most recent one 
.made, which is useful since the backup that is the most recent 
would generally be the most up-to-date. . Re 


' Typing a "p" Caen is ie onpieten as "Date Change") and pressing 
the RETURN key. while: at the Master Menu's: prompt will cause this 
prompt: 


CUE Det eee 
Enter Change else hit RETURN ===> 


The date that is shown is the date that was entered in response 


to the initial date prompt. To make a change, enter a new date ~~ =~ | 


and press RETURN, which will return you to the Master Menu. If 
you press RETURN without entering a new date, the system will ~ 
retain the date that is shown as the current date, 
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section Four: Backup Creation = 


Tne creation of a backup copy of a disk is extremely important. 
Backup copies provide some security in the event that an 
unforeseeable disaster might permanently destroy irreplacable 
files, This might include such things as a hardware failure in 
the Winchester Disk System, erroneous operation of a program 
(erasing files when they were meant to be saved), or power 
fluctuations, which might cause uncontrolled write operations to 
the disk. _ 


The Backup and the Restore operations are the most complicated 
Operations that may be performed by BRS, This is because they 
have the most variations and options available. However, because i 
both of these operations are so similar, this section on Backup: 
creation is the longest of the two in order to avoid. a lot of ‘ 
unnecessary repetition of the same instructions, 


To begin the Backup operation, type B. After the "B" you may 
enter any of the options that are listed on the menu with an 
"(B)" or "(B/R)" after them. Then press the RETURN key. 


The format for the Backup operation with options is: , : | re 


Select Operation (X /Y/Y/Y) sex=e>Backup/¥/F/P 


The "B" is the command for the Backup operation, and the 
"/V/F/P" are the three options selected as an example. Notice 
how the program completes the command by adding “ackup" directly 
after the "B" that the user entered.  _. 


-- Pripar 


Options: | _. 


A detailed description of each option that is available from the 
Master Menu, follows: 


/V--is the Verify option. This option checks each byte of the 
destination file against each byte of the source file to see 
that both files are identical after a file has been transferred, 
If the two files are not identical, this option reports an error 
message and states the record number (in hexadecimal) where the 
discrepancy occurred, 


The "/V" option is available with both the Backup and the 
Restore operations, | 


Se 


/W--is the Warning Message Disable option. Selection of this 
option suppresses all warning messages that may occur during the _ oR 
operation, Tnese warning messages are of two types, and occur | CP 
when the user attempts to: 
: 
| 


1) format ea disk 
2) delete files from the source unit 


ti! 
wea 


Page 75 | 


The Backup/Restore System | Backup Creation 


Qa hele bs pee hate Le oe Boos es Fs 
Sereseweee — . -ge erm en rreteumeus WF hy SRL clogs . 


eer” we. 


- 
Neem ae 


When the "/W" option is specified, the program will perform the 

requested command without warning the-user that one of these 
conditions is going to occur. The "/W" option is available 
during both Backup and Restore operations. Tne prompts that - 


lzoccuriin-operation-of-deleting files from. .the-Winchester disk 
=e ee Ne ere. and no-prompting will. pone ars me 
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<tthough files of the same-name- already- exist. on the Winchester 


crak et does this by: deleting, the file of the. same. name from 
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-Ef- the MP RM Boe ict is not Selected ‘and a “R/O file exists on the 
Winchester disk, the Seaguce eae as cas 
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“/Fenis the File Deletion: ok en. errr eB Of this ‘eption 


~"“Causes the program to delete the files from the source disk 


a 


after the files have been saved to the destination disk that is 


-being used for backup. The "/F" opts en is one ee Reeoe ware 
‘using the Backup. operation. | - 2 


« es ass i 
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/Penis the PKonpe ope cou. If the "/P" option ‘is selected, the 


user must respond to a prompt for each action that the user 


requests the program to perform before that request 1s 
performed. When the "/P" option is selected during the Restore 


Lo -OPeration,—-for-example,-the system--would-ask-the user—if the—-————...: 


existing files on the Winchester disk may be deleted. Only 
those files on the Winchester disk that have names that are 
identical to those being restored can be deleted. The "/P" 
operations. 


File Specifications: 


When a file or series of files are to be transferred by the 
Backup (or Restore) operation, the user must specify the names 
of the files that are to be transferred by the operation, and 
the names of the files that are not to be transferred. Based on 
the information given to these two prompts, BRS creates a list 


of files that the ensuing operation will affect. 


The first, file-specification prompt asks for the names of those 
files that are not to be transferred by the operation. This is 
the Rejection File Specification prompt. This prompt will cause 
all of the filenames that are entered to be left out of the list 
of files that will be transferred during the operation. 
(Further details are covered under "Rejection File 


| 
| 
option is available during both the Backup and the Restore _ 
Specification", on page 76.) 
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The second, file-specification prompt will ask for the~names of 
the files that are to be transferred by the operation. This 
prompt is the Selection File Specifications prompt. All of the 
filenames that are specified in response to this prompt will be 
placed in the list as files to be transferred by the operation. 
(More information is given in "Selection File Specification", 
below.) 


Rejection File Specification: 
If a Backup or Restore operation is selected, the prompt, 

Enter Rejection File Spec(s). s=2=2> 
will appear. 

An example of this procedure would be: " 

Enter Rejection File Spec(s). zs=s==>TESTFILE.DOC RETURN 
Filename responses that are given to this prompt are files that 
will be excluded from the list of files that are to be backed up 
or restored. Even if the same files are named in response to the 
next prompt ("Enter Selection File Spec(s). s==2=2>"), they will 


Still be excluded from the operation. Tnat is, the Rejection 
File Specifications override the Selection Files eRe ore ae 


The responses (and their results) to this prompt may be of three 
types: 


I--a CP/M filename may be entered: _ 


Enter Rejection File Spec(s). ses2=>TESTFILE.ASM 


@ the file named TESTFILE.ASM would be put in the list to be 
ignored by the Backup operation (assuming we had requested 
the Backup operation from the Master Menu). 


2--the CP/M filename of a batch file preceded by a semicolon (3) 
may be entered that contains a list of rejection files 
specifications, 


Enter Rejection File Spec(s). sss=s>sBATCHFIL.SUB 


® the batcn file, named BATCHFTL.SUB in this example, must be 
prefixed by a semicolon (:). All of the filenames listed 
in this batch file would be added to. the list of files that 
are not eligible for selection in the ensuing operation. 
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3--a RETURW may be entered. a 


Enter Rejection File Spec(s). s==2=s>RETURN 


& the operation would assume that a RETURE, pressed in 
response to this prompt, means that there are no more files 
to be added to the list of files that are ineligible for 
selection. 


All users' files are affected by this operation, i.e., it does 
not test for a user number match before rejecting the file from 
the operation. 


NOTE: No drive names are allowed in response to 
the "Selection File Spec(s)" prompt. Standard CP/M 
wildeards ("#" and "?") are allowed. 


BRS allows a maximum of forty (40) file rejection specifications ‘ 
to be entered. 


When RETURN is entered without a filename, the program assumes 
that all of the files to be rejected have been entered. fhe 
program then continues on to the next prompt. 


Selection File Specifications: 


--——--The-RETUBRN-in- response to-the "Rejection File- Spec(s)"-prompt —————_—-—"* 
will cause the program to continue onto: | 


Options for File Selection ot esas 
A All File Types” (Default) 

N - Nonsystem es 

S - System 

U - Current User # (Default) 

U® —- All Users 

Un = One Specified User # 


Enter Selection File Spec(s). (X /Y/Y/Y) ex2=2> 


The responses (and their results) to this prompt may be of three 


types; 
l-cea CP/M filename may be entered, with or without specific 
u-. Options. — 
—_- Enter Selection File Spec(s). ez2s2s>TESTFILE.ASH 
4 the file named TESTFILE.ASM would be put in the list for 
aa the Backup operation (assuming we had requested the Backup 


operation from the Master Menu). 
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@--the CP/M filename of a batch file preceded by a semicolon (3) 
may be entered that contains a list of selection files 
specifications, 


Enter Selection File Spec(s). s====>:BATCHFIL.SUB 


—...@.... the batch file named BATCHFIL.SUB, which must be prefixed 
by a semicolon (3), would be submitted. All of the 
filenames listed in that file would be put in the list of 
files to be affected by the operation. (See: "Creating a 
Batch File Specification List", on page 80.) 


3--a RETURN may be entered, 
Enter Selection File Spec(s). s===>RETURN 
© the operation would assume that a RETURB, pressed in 


response to this prompt, means that there are no more files 
to be put in the list to be operated on. When the RETURR 


is pressed, the BRS program performs the operation on all =P, 
of the filenames that are in the list, and then returns the eh 
user to the Master Menu. wr 


Each individual filename or each filename for a batch file that 
is entered may utilize the options that are listed on the menu 
with the "Selection File Spec(s)" prompt. The options determine 
the types of files that will be affected by the. operation of. 
either Backup or Restore. These options are described below in 
the "Selection File Options" section. = 


NOTE: Drive names are not allowed in response to 
the "Selection File Spec(s)" prompt. CP/M 
Wildcards ("*" and "2?") are allowed, 


When a nonexistent filename is specified in response to this 
prompt, the message 
No file found for Entered Spec, : 


is displayed on the terminal. 
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ba 


Selection File Options: 


Each option here is a limiting switch that identifies the file 

type and user number of the files named in the selection file 
Specification. These switches are identified as secondary 
switches to differentiate them from the primary switches 
available from the Master Menu. 


Options for File Selection Spec(s). 


A - All File Types (Default) 
N - Nonsystem 

S - System 

U - Current User # (Default) 
U* — All Users | 

Un. —- One Specified User i} 


" 
te 
{3 
Vv 


Enter Selection File Spec(s). (X /Y/Y/Y) 7 


“When a filename.ext is entered in response to the selection file 
prompt, the user may enter options. An example of whichis given 
by the prompt as "Enter Selection File Spec(s). (X /Y/Y¥/Y) 
zs=xs=>" prompt, where "X" is a PEORer CP/M filename and each "/Y" 

.is- an -appropriate option switch. These options may be entered 

. aS Switches directly after the filename (shown in the prompt as 
"/Y/Y/Y"). If no options are entered, the program assumes the 
default values for each option (shown on the menu in 
parentheses). 


The description of these secondary, limiting switches are as 
follows: 


/hke-is the switch for All System and None-System files, and 
enables the Backup or Restore operations to transfer both System 
and NoneSystem files. 


-/Nweis the switch for Non-System files, and allows only Non- 
System files to be transferred. . 


/S--is the System files switch, and allows only System files to 
fi ve transferred. 
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/U--is the switch for the Current User, and enables only those 
files belonging to the Current User to be transferred, 


/U*--is the All User files switch, and allows all users! files 
to be transferred, re ae te A 


. - ~ 7 8 md 
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/Un--is the switch for files of User number "yt, where "n" is an 
integer from zero (0) to fifteen (15), ‘incIusive. It -allows’ only 
the files of User number "n" to be transferred, 


Another example of a filename with options might be: 


Selection File Spec(s) z=>TESTFILE.COM/B/U#--- 
Here, TESTFILE.COM is the filename, /N -is a limit for only Non- 
System files, and U#® allows all user files to be affected, 


Selection File Errors: 


During the operation of input to the Selection File, two types 
of errors are common: a 2.2 


Invalid Option Format or Selection 


ane - Qe a i ah i OM a gg ST hu a a i ea re a a th 


Invalid User Number or Format 
Specification, 


Backup Option Defaults: 


The default values for the Backup options are marked on the 
menu: "A - All File Types (Default)", and "U -— Current User # 
(Default)", If the Backup operation is performed without 
Secondary switches, it will affect all file types that may 
belong to the current user. 


Creating a Batch File Specification List: 


SP LL NINE 88 emt wend estwennreste enn NEN Eee econ 


Any editor that is capable of creating a text file may be used 
7 | to create a Batch File for use as a Specification list. The 
pom CP/M ED.COM (editor) will work fine. 


The Backup/Restore System zz + Backup Creation 


If either error. occurs, correctly retype the Selection File 
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The Batch File may be opened under any valid CP/M filename and 
with any extension. Tne names of the files to be specified are 
then entered, one to a line. Each line must then be terminated 
with a carriage return. For example, examine this sample Batch 
File, TESTLIST.BAT: | 


ACCOUNTS1.DAT 

ACCOUNTS2.DAT 

.PAYROLL2.DAT/U3 : 
INVOICE1.DAT ! 
ADVENTUR.BAS 
FINANCE.COB 3 
STATS.FOR/S/U5 
LETTERS. TXT 


a a ee eee ere 


When called in response to either the "Selection File" or 
"Rejection File" prompts, TESTLIST.BAT will be opened and the 2 | 
required operation will be performed on each of the files 2 
contained in the filename list. The Batch File may be called 
with any options available to the particular operation being 
performed, | 


Calling a Batch File Specification List: 


If a filename of a batch file that contains a list of Selection |: 
File Specifications is called, that filename must be entered 
with a preceding semicolon so that it would appear as 
"sfilename", Tf a filename for a batch file is entered aS a 
response by the user and that file is not found, the error 
“message TT pore PRRs ra DO Seen CN mI MEIN OS le aad Wee ea ae nT 


Submit File Not Found 


and BRS will return to the file specification prompt. Using the 
name of the Batch File example given above, this would be 
performed as: 


Enter Selection File Spec(s). (X /Y/Y/Y) szz22=>3TESTFILE.BAT 


This would cause BRS to open a Batch File named TESTFILE.BAT and 
use each of the filenames contained therein as the specified 
files on which to perform its operation. Options may be 
specified directly after the filename of the Batch File, exactly 
as they may be specified after any filename, BRS displays each 
filename in a batch file when it uses each file as a file 
specification. 


we NOTE: Option switches are ignored if they are 
Caneel appended to the filename of the batch file. But 
Switches may be added to the filenames within a 
batch file. 


aT? : : 
. ee Ce en en nn ee a a ee Oe eS eC a 
ee pepe eee Ar nen oes 
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systema | <Backup Creation 


3aThe..Backup/Restore 


= - - _ - we 
a = = 
=o 


. Ending the. Selection. File Specification: eo 
_ When. Sneries to this. prompt. are eoupreveas ~ press RETURN in 

-response to the prompt. The RETURN response will cause the 
Backup or the Restore operation to be executed, and then the 
program will return the user to the menu. | 


waa a Re ne TET TOWE 


If a- flies ie 30 long that it cannot be poapieteis contained on 
one- -destination disk or if a series of files has filled the disk 
and_there: are more files queued in the Selection list, the user 
will be instructed to insert a new disk and the operation will 
-continue. This allows the backup'or restoration of a file or a 
series of files whose quantity - is pare ven an individual 
-floppy disk ean hold, - ES : 


-Directory Save: 


When all of the files that were specified by the user have been LOS, 5 
copied, the user will be asked to reinsert the first disk of the Noes 
“backup disk set and the working directory will be updated to ' 
that disk. The wore. Girectory will then be deleted from. the... 
Winchester disk, i 


i 

| | : 
File Delete Option: | | ; BS 
tr in response to the Master Menu prompt, the user specified the 
"/F" (File Deletion) option, the files that were saved to the 
floppy will be deleted from the Winchester disk. No files will 
be deleted until the Backup transfer has been successfully 
completed. , 
If the user selected to be prompted by the BRS program in | 
response to the Master Menu prompt, the user will be asked by | 
the program whether or not to delete a given file before it 
actually deletes that file. The message that would appear would 
be: 7 

Found User# 00 TEST.ASM on Winchester Disk. Delete? (Y/N)<Y> 
Here, TEST.ASM would be the filename that BRS had located from 
its list of files to be deleted. The question is ta be answered 


with either a "Y" or an "N", The default of "Y" (shown as <Y¥> 
on the monitor) is assumed if a RETURN is pressed without typing 

. either "Y" or "N". Typing "N" will cause BRS to Skip over that 
particular file and not delete it. 


WARNING Data-on this Disk Will-be DESTROYED! 
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- 
Smee ee bag aT a 
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Alsé—-when-using-the-delete-option-(with the "7D" switch), if 
the -warning messages are. active, . the ~user will be asked to 
verify each file that is to be deleted. ‘If the user presses 
RETURN,.:- the files. will. nat. -be. deleted. “If any other key is 
pressed -Canything. except. the- RETURN. key), the files will be 
deleted. The message that occurs ‘during this operation is: 


eerie. 


eeettwarnimg! Files on Winchester Disk are Going to be Deleted####® 


Tv 2 #::, -Enter COR) to. Cancel. Deletion, Process 


- 


LOE £ Qas ~*~ owe ms we 
If -the warning. messages ‘are “disabled: by” “the ~~ wy yt ‘option switch, 


BRS will, over ride. the prompting - “of: deletion - ‘selection, and 


~ = ~ 1 


delete all ‘of - the selected’ Files. J 


< -_ ~~ = ry 


—_ = 


—-—- ~ - - ~ 


rg ; 2 . : 
o- - -_ -~ a oe. 4 a tS ” qe Oa es s. — ta se ba ~ >> « ss Ss 
bad bt — * 

Se ee eo ae = 


a 


purine the ‘Backup Operation: 


When- all. Rejection and Selection file specifications have been 
entered . the séreen will clear and the following message will 
be. displayed. a a. oe ee 


Load Drive X: with a Blank Floppy: Disk 


Enter Carriage Return When Ready 


The "x" would be ‘the drive name of the floppy disk drive. After. 
RETURN is pressed, the program will prompt: ae 


Which density? (S=single, D=double) ==s==2> 


Enter the letter designating which of the two densities you want 
to use to store the files. When that is entered the terminal 
will display: 


Press RETURN to begin. 


Press RETURN, and the operation will continue. 


A a eee pee Rak eRe Oe alleen eran ae 


The Backup/Restocre Systen 7 Backup Creation 


“ee 


If the files fill up the floppy disk and there are more files 
listed as Selection Files, you will be instructed: 


Load Drive X: with a Blank Floppy Disk 
###WARNING Data on This Disk Will be DESTROYED!! #8 
Enter Carriage Return when Ready 


If for some reason one-of the floppy disks is unformatable, the 
following message will appear: 


. Unable to format this disk. Place a different disk in the drive. 
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Section Five: Restore Files 


The Restore operation's primary ‘purpose is-to recover or restore 
files -from:-a previously generated- backup copy that was created. 
This operation reverses the process that was performed on the 


original files .when.a-:backup: copy :was.created.:.:.The Restore 
operation restores the files to their original configuration 
should th'e need arise to ‘work withsthe-backup _G6py.. il 2 **? 


The Restore operationéis-started from the Master Menu by typing 
R and then pressing RETURKE. The Restore operation is 
essentially identiéal’ to: the Backup operation. (see:. "BACKUP 
CREATION". “above,ifor: complete: details). The primary difference 
is that the files are transferred to the device specified as the 
Winéhester disk :from- the: device specified as. the: floppy disk, 
whereas the Backup operation transfers files from the specified 
Winchester disk partition to the specified floppy disk. There 
is one exception to the usable options. 


Invalid Option: 


When the Restore operation is requested from the Master Menu, it 
may not be used with the "/F" (File Deletion) option. The "/F" 
option is only selectable with the Backup operation. It is 
marked on the Master Menu as selectable with (B) ene eek 


ppeemeerenererenes: |) ite it.is entered asan.option,.BRS- wWill.ignore it. pases sceasctgo ta eee ag eT ae a! 


Directory: 


Another difference between the the Backup and Restore operations. 
is that Restore will first ask for the Directory Disk to be 
inserted. This disk provides the information necessary to the 
Restore operation so that it can prempt for the correct disks to 
be inserted and so that it knows the location, Volume Number, 
and Dates of the files that are being restored. This Directory 
is written to the first disk created during the Backup 
operation, which is also the disk that the program asks to 
update at the end of the Backup operation, 


Directory Error Hessage: 


Should the user insert a disk that has no directory written on 
it, an error message will be generated. 


Wrong Disk Inserted!! - 
Enter RETURN For Master Menu. 


f When RETURN is pressed, the program will return the user to the 
at Master Menu, 


‘he Backup/Restore System Restore Files 


Operation and Options: | . os 


The Restore operation uses the same command format and options 
that are available with the Backup operation. (See: "BACKUP 
CREATION" for further details.) Type R,followed by any options, 
from the Master Menu to begin the Restore operation. Restore 
will then ask for the directory disk of the disk set that you 
wish to use xe restore ae previously eeneraved backup files 
from. 


Load Drive X: with Vous 01 of Disk Set. 
Enter RETURN when ready. 


In this prompt the "XY:" device designation is the device that 
was specified as the Floppy Disk Drive during the initial BRS 
prompts. "Volume 01" is the directory volume number of the disk 
set that the user is going to perform Restore with. 


The BRS program checks to see that this is indeed a Directory 
Disk, and if it is, BRS then displays, 


Backup Disk Set: Created 12/27/82 
Start vol. 01 
Last vol. nnn 


Is This The Correct Backup Set? (Y/N) <Y>_ ‘fee5) 


-_— + ee he ee ES A 


anew: “ann” is the pniese Volume number inthe disk set that is 
indexed by that directory. If this is the desired disk set, the 
user types RETURN (for the default of <Y>, Yes) or Y and presses 


 BETORS. Type H and BETURB if it is not the correct set... With ......... 


an "N" response, BRS will ask for the Directory Volume again. 


The Restore operation then continues on to the entry of the 


Rejection File Specification (see: "File Specification" under 
"BACKUP CREATION", above), After the Rejection Specification is 
completed, Restore will prompt for Selection File Specifications 
(see: "Selection File Specification" under "BACKUP CREATION", 
also above). 


When these two File Specification prompts have been completed, 
Restore compares the list of selected files that it has created 
against the directory to determine the location of each file. 
Restore then prompts for each Volume to be loaded that contains 
a file or files to be transferred, 


An example might be: ie 


Selection File Spec(s). sxs=>TESTFILE.DAT RETURN 


Selection File Spec(s). s===>RETURN 
Load Drive C: with Volume 02 of Disk Set. 
Press RETURN when ready. 
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Load Drive C: with Volume 03 of Disk Set. 


aio" Press -RETURN when ready. 
ane punet ron: OU ete tt Se 9 ee | ! 


aes world ‘sont tinue umtedl ie program has restored all files 
that were*specified-.by-.-the° user: in response to the Selection 
Specification: prompt; : Afitter-completion, the program will return 
to ‘the. Master. Menu: for-further operations. 


= Cel Pegi - s. 5) 


Wrong Disk error 


a - -_ 2 = + ar a dha wo a 
ert Se? AZ - /- Jf & . .- on ata “F be Ea 


At any? point: if: the: users danserts the wrong disk into the drive, 
the error message 


ry = = ° € = @ r Dd ° » rd < 4 = s e rT £ rm 


So. tee OR ee ee Eee Eee ee 
se ¢Weong - -Di-sk: Insertedt!::~- et a rg ee 
“"s Enter eee when ready. a ae a 


ae ~ - . ~ Q “ oom ee: 


will appear, and the user will then see the prompt: 


Had iene » owen Volume 00 of Disk Set. 
Enter RETURN ey ready. 


a ay os A i 


where the "oon is the appropriate Volume number. 


a coenatiannteertemanlii Ten apeeswom re tae ne ene 
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Section Six: Compare Files 


When a backup copy is created or when a files needs to be 
restored from a backup copy, it is critical that the newly made 
copy contains the exact same data as the copy the file was made 
from. When large amounts of data are transferred to or from 
various media, it is extremely important to be able to determine 
the integrity of the transferred data. The "/V" option allows 
verification of this sort at.the time. the files are being 
transferred. If files are updated later on or if the "sy" 
option was not selected during the transfer stage, Compare will 
allow the user to ascertain integrity. 


The Compare operation begins when the user has entered a "C" and 
pressed RETURN in response to the menu's prompt. This operation 
Starts with the prompt: | 


Load Drive X: with Volume 01 of Disk Set. 
Press RETURN when ready. 


The "Drive X:" in this prompt would be the drive designation pn 
that the user specified as the Floppy Disk device in the initial ger 3 


prompt sequence, "Volume 001" is the Directory Disk of the Disk 


The program checks to see that the disk that is loaded is a 
Directory Disk and if it finds the Directory, it will display, 


Hon nom nomnn nom Baekup Disk Set: - Created 10/17/82 


Start vdl. 01 
Last vol. nnn 


Is This The Correct Backup Set? (Y/N)<Y> e=2=2=> 


where "nnn" is the highest Volume number thatis Poceee by that 
Directory. 


The Compare: operation will then prompt: 


Compare Function 


SP AD OM OP OD OE ED CED AP CR ON CD CD OUD ORD OER END 50D CHD EHD GED GD OEP OD aD 2 OW OD GE aS GS am on) CW Ow OWT &S SD GD Ee ED ow ED aw a Uw 


Enter Winchester Disk Filename 2z=2==> 


To this prompt, the response should be the name of the file to 
be compared that is on the Winchester disk. After entering this ' 
filename, press RETURR. Cp 

a 


Set that the user wants to perform a compare operation.on,....... 


a ca SR rr enna cn, STS S A TTA TTS STS NLS SEM STN. Oe fF bn raat te ~ 


—J 
ye ot ET ws is. Ve : 
ae 
e 


“Woluhe toate -concains; whe speci tse ti ke that. ts uo be compared. 
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NOTE: If a device name is entered in response-to | 
the Compare prompts, the error message = 


Drive-Specifications NOT allowed. 


~. Will be displayed. This is because the devices 
-were already specified during the initial prompt 
_sequence, .CP/M wildcards (the "#" and the "?") are 
‘also, not allowed during the Compare operation. 


i 


} 
th 
rA 


tbe are “Operation will then prompt, 


0 AN 


erates "= Eater Floppy Disk Filename s===> 


a ee a as 


dievioe specified as the floppy disk. After entering the name .of 
the file that the Winchester disk filename is to be compared 
against, press RETURN. 

Compare will next request the specific volume be entered where 
the file is located. An example would be, 


~ , 


- rn ia 


| “bead Drive Cs: with Volume 014 of Disk Set. 
. “>. Enter RETURN when ready. 


on we ree 


where "Cs" would be the device designation that the user 
Specified was the Floppy Disk device, and "Volume 14" is the 


The Compare operation compares each byte of both capes If the 
files are verified to be identical, the prompt, 


a ie See cee | eee ae CE ae a men eer 
ee ete a ee ee te a er er te ne ne ee 7 = - 


“Compare Complete (Hit RETURN For Master Menu) 
Compare Function | = 


Enter Winchester Disk Filename sx22=> 


will be displayed again, and another comparison may be made, 


NOTE: The Compare function may be used to compare 
the current user's applications. The CP/M “User" 
command must be used to change the current user 
number if files belonging to other users are going 
to be compared. 


te 


Compare Errors: 


If the files do not compare exactly, the program will indicate 

that the data did not compare, and give the hexadecimal number | 
of the record where the error was found. When a place is found | 
where the two files are not identical, the Compare prompt will 

be repeated. 
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In this instance, the user must determine which of the two files 
Should be deleted and then either performs the Backup or the 
Restore operation on the file again, 


The following is an example of the display that will appear when 
two files are not identical. — 


oy 


- Compare Function 


SE he: ca mu eS eh ‘esun”Qu Gee eum “tui “Ses tu ia“ tsa“ mse Sa Sees eee a a a sca es es 


‘Enter Winchester Disk Filename 2==s=>TESTFILE.TXT 
Enter Floppy Disk Filename ==2=2=>TESTFILE.TEXT 
"Load Drive C: with Volume 014 of Disk Set. 
Enter RETURN when ready. | _ = | : 
(a momentary pause 
Reading File TEXTFILE.TXT occurs here.) 


Data Miscompared at Record OOOE Reading file TESTFILE.TXT 
Compare Function | ES 


Enter Winchester Disk Filename 


The Compare operation may be terminated by pressing RETURN ~~ 
‘in response to either file prompt. Upon termination, the Master 


Ending Compare: 


Menu will be redisplayed. 


Se 


ac ta ama canta DERE, steer tf 8 pepe ety cme 


Fe SE OP 8 I Re ee I TE Ee ES SS a POT POEM em me gS SEE HS Pee wk ge ge OAT ge OL - 2 ee atw ee Tee a) ae S| oi aes ere. 2 


27 ¥ “= kl 7S : om = = ad 
BZ eFC Gl as Se Ems ae er eg 
. Gee ete 


- cere 
The Backups Restore systen ; List Directory 
ee Sissi eras: earns 


~ t wt j £ - ww ee - c - ee 
ee oe eo eae - » eo z c ew 
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“Section “Seven: ‘List Directory 


» 
3 o wv - ae 1 2 —_ + “ ~~ ~ 
oe oe 7 7 ead ao os pe - 
- « - ‘ -_ ff he ce 2 €. Be te om wie mote ~ er: a Se 
- 


a. OS ew ee Te Ne ee ek ee ee me Oe ee Ue — er St ee Oe we 


information besides the filename that is necessary to 
distinguish between -disk-sets- containing identical filenames. 
The List “operation gives the Date that the copy was created, the 
number of, Volumes in.that- particular disk set, the User Number 


. m~a ww ey 


of each File (to whom. the file badeneel and the Volume number 


Ye a ns 


In response .to;the- Master Menu prompt, if the user types "L" and 
presses RETURN, the user will be instructed to insert the wO1" 
volume of a disk. set...The. BRS program then checks to see that 
this is indeed a Master Directory, and if so, it then displays: 
Backup Disk Set: Created MM/DD/YY 
| Start vol. 01 
Last. vol.-nn. 


Is This The Correct Backup Set? (Y/N)<¥> mess> 


If -the Volume-that-is-inserted—-is not-the-Master Directory-of-a’- 


disk set, BRS will state: 


—~ Wrong Disk Inserted!! 


An example of a sample directory list appears below. 


Listing of Backup Directory 
Created: 02/15/80 
Highest Volume Written: 03 


FILENAME USER VOLS FILENAME USER VOLS 
C:TEST1 COM 00 01-01 C: TEST REL 03 01-01 
C: TEST ASM 03 01-01 C: TEST -PRN 15 01-02 
C: TEST COM O07 01-01 C:FILE1 ASM 15 01-02 
C:FILE2 ASM 15 02-02 C:FILE3 ASM 09 02-03 
C:;FILE4 ASM 15 03-03 
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CHAPTER SIX: THE CONFIGURATION UTILITY 


H - 
VEC L es Sees 2st Pores ers 
© A sites Description of the CONRFIGUR.COK 
She Lisi at 2% PLD ES Tre terre wit €@€ eett cf ect tt ae aes 
t= as ) ‘How te Begin Co onfiguratio on. tes! Ls ae eee Seite eo eae oe oe ee ae eS 
ey ee fF Lf fe? cS CO eee Ss Tae s. Bk Bees etek. 2S 
SiS Vattg- to Fre ‘Standard Heath/Zenith Configuration. Bae ee ea ages 
EEL gS > oer eS Toe = : aoe ee 
pee ee *< The ‘Options ‘that ‘are “Available trom Configur' 3 ee 
a ee Ce ge ek ee “main menu. ~" Pian, Sere ere TESTS erent Sse et were 
Cl Re CSS Maeee Perle” ee SS See tee 
7 @ vera tne) ane. Peer .Centieure Eton. Operons: 
oe ira dine ; ae lees = earn ome z eK, 
ee ee ‘The Disk Parameter options. ~* ; - 
oe “ Optiers for the: Default Input/Output Devices. 
| -@ Autematic Program Control for Warm and Cold 
, Boots. 
rnrm—, . = 
[Ce s) 
Naw 


The Configuration program is designed to facilitate user | 
“customization of Heath/Zenith's CP/M BIOS to a Cee a 
Operating environment. Use of this program allows the user to 
set the characteristics of the terminal, printer, disk drives, 
and the default, woe odes mePpene for input and output to 


-.-.-— physical devices.----: i ene 


CONFIGUR is run by typing CORFIGUR and pressing RETURN from the 
CP/M command mode prompt. Generally, the user may wish to run 
it after first installing a system, and then it might not be 
used again until the user decides to add another piece of 
hardware to the system. 


When run, CONFIGUR will identify itself and then determine the 

hardware available, The program will automatically determine 

the amount of Random Access Memory (RAM) that is available for 

use by CP/H, the number of serial ports, and the number of disk 

drives, When CONFIGUR tests for the disk drives, the program 

will select each (potential) drive and ‘attempt to determine if. 

that drive is available (connected and active). There does not 

need to be a disk in each drive for..this particular test. 
a However, if the drives are to be considered for configuration 

purposes (i.e., to be counted as devices that CONFIGUR will . 
include in the configuration process), they must be powered up Cv 
and connected to the syste, : 


oR we 
ae 


i 
! 


he 
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Configuration Utility i. Soest = 22. Basic Description 


NOTE: If you are using the H8 computer with an H8-4 
serial card, you will be required to type spaces in 
order to continue the program. Typing these spaces 
enables -the program’ to-.determine the baud rate that 
is uséd 'vy'-your terminal. 


; Fen : x. Brie ce a mee &. 
& Koy Le Gfeein Lerfifpervesipe:. 
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Section One: Beginning COWFIGUR Operation 


When CONFIGUR nas been invoked, it will commence by printing a 
Summary of the hardware that it locates, An example of this 
Summary might appear as: 


32K HEATH/ZENITH CP/M 2.2.03 
FOR Z67 DISKS WITH OPTION(S) P2I 


HEATH/ZENITH CONFIGURATION PROGRAM 
VERSION 2.2.03 
SERIAL NUMBER: nnn-nnnnn 


THIS PROGRAM CONFIGURES THE CP/M OPERATING SYSTEM TO A 
PARTICULAR HARDWARE ENVIRONMENT. 


PLEASE WAIT DURING HARDWARE VERIFICATION... 


H/Z89 WITH 64K OF RANDOM ACCESS MEMORY (RAM) 
Z67 8 INCH HARD/FLOPPY DISK INTERFACE 

CRT BAUD RATE IS 9600 7 
OO ADDITIONAL PORTS FOUND © . Oy 


__ DRIVE A. DISK. IS.WRITE PROTECTED... __...-.-.. ei eecengest atl 
MODIFICATIONS WILL NOT BE MADE TO THE DISK FOR THIS CONFIGUR RUN. | 


STANDARD SYSTEM (Y OR ND)? io © 2 


The amount of RAM (memory that may be read from or written to), 
the number and type of disk drives, and the number of serial 

“ ports will vary, depending on the particular hardware that is 
present. What is displayed on your terminal will be dependent 
on your particular hardware environment. 


NOTE: If configure is run from a disk that is 

write-protected, it will warn the user that it will 

only modify the copy of BIOS that is currently 

resident in memory, and that it will not change any 

of the values that are in the BIOS on the disk. 

This can be useful in testing a new configuration 

(or during the preliminary boot of the system). 

™You may now select the "Standard System" by typing a "Y" to the 

prompt given at the end of the display just presented. 
Selection of the "Standard System" will configure the BIOS for 
the standard hardware configuration that is suggested by Zenith 
Data Systems. The configuration will now be adjusted to reflect 
the hardware that CONFIGUR has found, (The Heath/Zenith 
Standard System Configuration is detailed in Section Two on page 
96. : 
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Consistent Version Check: “Sg 


CONFIGUR checks that it and the BIOS are consistent in version 
number, otherwise the program might modify the incorrect 
portions of a BIOS since the various versions have used 
different locations for the storage of various values. 


If the program finds that the BIOS is not of the same version, 
an error message, | 


INCONSISTENT Version number...can NOT configure!! 


will result and the program will abort. This type of 
inconsistency may be a result of not copying the most recently 
released version of the BIOS.SYS file onto the disk in drive A, 
or of using an outdated version of CONFIGUR. If you are unable 
to correct the problem, call or write to Heath or Zenith Data 
Systems. | 
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Section | ues ‘The ps loL Aa aE a scencare Systen : 


is - - ae ~~ - goe@w . * - 
ne em ate ate ee ee ee 


wd 
a a a - 
_ o~ o& = . ~ ‘ Woe os s - S - -~ - — 


e* yTrer, - &e a 2 2 ~- 


Tne-"Standard: heaeny tena Ch: euctent consists vo the Poriewine 
Aeach- of the items that are listed below will be. fully discussed 
later in this Chapter, in their respective sections): | 


od ~ - - . « rad - 
- ~ * aa 5 ad > we . - - - 
- cia 
ee 


ae ee Sree ee Paes eee Tee 2 ae SS OS See eS See 
wey E° 9, L7 HEEB, 
Number of drives found, step-rate set to 30ms. 
TAGs ee oe = Rees Va Canes oO see ee 
bee at port me 7000 baud, no nulls. | ; 
~£i eg) 7 DSSS, Ba. ee C228. eee 0 
gai. bbe peck: 3200, 300 baudy no nulls; EO yaa weds el atl Sea 
releesec versicr of oS eae co oomie ee ee 
MODEM cess 3309; 300 baud sno: wulls, no. uppercase. mapping. 
ee a a forse —— ae (ate Le: See os Tae 
Line. Seinber at ees 300. 4800 baud. no nulls, no RePEc 


ECHO on delete on console. 


-IOBYTE set as: CON=CRT, RDR=UL1, PUN=UP1, LST=LPT. (See the 
discussion on the "Default I/0 Configuration Sub-Menu" for an ce 
explanation of these settings.) ee 


Frinter Ready ‘Polarity: (LOW 8 


Printer Ready Signal: RTS (Pin 4) 
Detailed Disk error pongo set pee 
ae “Automatic. program COnvrGn hoe warm Beet set FALSE, 


Automatic program control for cold boot set TRUE. 


Automatic program command line is set for CONIGUR. 
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. 
| Section Three: The Hain Henu <i 


If you do not choose to use the "Standard System" configuration, 
you would type H in answer to the initial configuration prompt, 
as shown above in "Beginning Operation". When an "N" is given 
to that prompt, alternate options will appear in the form of a 
series menus. The user may select any of the options that are 
desired, which conform to the particular hardware that is 
involved. The first menu that appears on the screen is the main 
menu. Its sole purpose is to enable the user to end the 
CONFIGUR program or to select one of the other menus that 
contain the options the user wants to check or adjust. The main 
menu will appear on the console as: 


CP/M Configuration 


Set Terminal and Printer Characteristics - : 
Set Disk Parameters 

Change the Default I/0 Configuration 

Automatic Program Control 


Gow > 


Configure, making changes to memory only 
Configure, making changes to both memory and disk 
Quit, making no changes 


NK P< 


Selection: 


The options in this menu, and those menus ‘that. follow, are 
selected by typing the correspondent letter code that is 
displayed to the left of the option that is desired. As 
example, the user would type B to select the "Set Disk 
~ Parameters" menu. ee 7 t= a 


Option "X" on the main menu will make all of the configuration 
changes to memory only. This makes a temporary change to the 
BIOS and will only be active until the disk copy of the BIOS is 
reread into memory, during a cold boot. This selection is 
recommended when you need to test any changes, so that you can 
try those Sree before making that configuration of BIOS 
permanent. 


Option "Y".-will only be displayed if your disk is not write- 
protected (see "NOTE:" below). If you select this option, both 
the BIOS resident in memory and the BIOS that is stored on the 
disk will be changed. This change is considered a permanent 
“- change (see "CAUTION:" below) because from there on that altered 
7 BIOS will be the one loaded when that ditsk is used to do a cold 


a boot. 


cae NOTE: Configure warns the user in the initial 
“ hardware summary that it will only modify the copy 
of BIOS that is currently resident in memory and 
that it will not change any of the values that are 
in the BIOS on the disk if that disk is eeorer 
protected. 
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CAUTION: Though this option creates a BIOS that is 

considered to be permanent, it may be reconfigured 
: >" again to reflect other changes, unless you have 
~~. . eonfigured it in such a way that no input or output 
>. °. from your existing hardware can take place, and if 
it were your only existing copy of the BIOS 
s7-_.. (hopefully you have made backup copies of your 
s*:_.7-disks and it is not you only copy). Therefore you 
t=... ‘Must “exercise extreme caution, preferably by first 
rev. utilizing the "X" option to pre-test a newly 


“7 =. configured BIOS to see that it works properly 


*etr.zibefore:- saving it:to. disk. 


Option "Z" is provided to safely take you out of the CONFIGUR 
program without changing any of the preexistent values in the 
BIOS. If you have any doubts about the correctness of any 
changes that you have made, you can always return to CONFIGUR 
after consulting your documentation and thinking for awhile. 


Each of the sub-menus also provides a means of returning to the 
main menu via either a "Y" or a "Z" option from their lists of 
| possible selections. The "Y" option in a sub-menu will save the 
im changes that have been made and then return to the main menu. 
The changes are not actually made at this point but are stored ae 
until you exit the program. The "2" option in a sub-menu will Se 
cancel any changes that were made with that sub-menu and then 
_ return to the main menu. _ 


An invalid input by the user will.result in a "BELL" character 
(beep) on your console. If this occurs, reselect the option and 
reenter it. When an entry has been made, a Single carriage 
~peturn (RETURN) after the new value is entered will cause that | 
_.Submenu to redisplay. The new value will then show in place of 
the value that was previously listed. 


' 
Cn 
rf 


—— 
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Section Four: Terminal/PrinterCharacteristics 
. Sub-HMenu 


The terminal and printer characteristics sub-menu allows the 
user to set the physical port and baud rate assignments for the 
serial devices in the system. It also allows you to specify 
that the device is capable of accepting only uppercase 
information, in which case the BIOS will convert all lowercase 
information, which is directed to that device, to uppercase 
before it outputs it. 


Additionally, you may specify the number of "null" characters to 

‘be sent after a carriage return (RETURN). The number of "nulls" 
“specified to occur after pressing RETURN will provide the amount 
“of delay that is required by some devices to return the 
“printhead/cursor to the lefthand side of the carriage/screen. 


Further, this sub-menu allows selection of the RS232C line and 
-polarity of the "printer ready" signal. Polarity, as used here, 

‘is a voltage level. Two levels of voltage are used by the 
-computer/printer line connection for the "printer ready" signal. 

- Low polarity, the lesser of the two voltage levels, is used by 
Ct, -gome printers to tell the computer that the printer is ready for 
L more text. Other printers use High polarity, the greater of the 
two voltage levels, when the printer is ready to receive text. 


ww. Most Heath/Zenith printers use. the Low polarity signal but you. | 


should refer to your printer's operation manual to determine 
what signal line and polarity is used. 


The RS-232C lines that a printer generally uses to let the 


_.. computer know its status are the DTR (Data Terminal Ready) and = = = — 


the RTS (Ready To Send) lines. The DTR line (pin 20) signals to - 
the computer when the printer is nowered up. The RTS line (pin. 
4H) tells the computer when the printer is ready to operate. 
Manufacturers of printers other than Zenith Data Systeius 
sometimes use these two lines differently, hence they have been 
made user-selectable, 
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The characteristics sub-menu that allows the user to define 
these functions will appear as: 


A CRT: Baud rate: 9600 Port: OE8H = 350Q 
B TTY: Baud rate: 300 Port: ODOH = 32009 
C LST: Baud rate: 4800 Port: OEOH = 3400 
D UL1: Baud rate: 300 Port: OD8H = 3300 
E  UP1: Baud rate: 300 Port: OD8H = 330Q 


F Force output to upper case on CRT: TRUE 
G Force output to upper case on TTY: FALSE 
H Force output to upper case on LST: FALSE - 


I Nulls outputted after CR on CRT: 0O 

J Nulls outputted after CR on TTY: 0O 

K Nulls outputted after CR on LST: 0O 

L Echo on DELETE: TRUE 

M Printer Ready Signal Polarity <HIGH,LOW>: LOW 

N Printer Ready Signal <DTR (Pin 20),RTS (Pin 4)>: RTS 


Y Finished, make changes and return to main menu 
Z Quit, make no changes and return to main menu 


Selection: 


Terminal/Printer Sub-—Menu 


Options — "A" ¢} through. ten will prompt for ‘baud rate and port 
number. CONFIGUR will complete the baud rate input as soon as 
enough characters are input for it to determine if it is a valid 


baud rate. Valid baud rates are: 38400, 19200, 9600, 4800, ~ 
2400, 1800, 1200, 600, 300, 150, 134, 110, and 75. 


For example, if C were typed, the terminal would show: 


LST Baud Rate: 


Typing t2 would extend the line to appear as: 


LST Baud Rate: 4200 #£=Port: 


Typing OEO as a response for the port number would cause the 
prompt line to appear like this: 


LST Baud Rate: 4800 Port: O£O0 
After the port number to this prompt line has been entered, 


configure would return to the sub-menu. That sub-menu would 
then display the new values. | 


Oe ee oe fe. cmense wr 10991 


gee - 


smThe. Configuration | Mei lity Jer 


—=_—~ 


-~ 


i an) 
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CPT SDT ee RG lhe oe rN iP Ot een = 


---NOTE:. This option changes.the.baud rate at_ whitch. 


ees. «computer expects. tO. receive ‘data ‘froma given 


- 


device, it does not change the baud rate of the 
device.. If the bayd-rate.of.the CRI. -is to be 
changed, ‘first -make the desired: change: in.CONFIGUR.,. 
Then physically. change. the. baud. rate of tthe CRT to 
match the selection, made,. after you. -éxit from 
CONFIGUR..._ ‘If -the CRIs changed. first ,::you will be 
unable to communicate with the configuration 
or pregram,.and umep res okQ- com BPE OLE the operations. 


i 
La 


ADE i eee 


we © + © & 


3 


ad = 
os 
See ce ” -— « OCS ras r vee ads af es 
we Sa? 


letter “Q" for notating Octal . -because.of.the narrow distinction 
between, ‘the character ‘far, . a rletter.2 0": and. the character for 


numeral, zero) - radix, suffix. is- - nok. required as input. The valid 
port numbers are: 3206 (ODOH), 330Q (OD8H), 340Q (OEOH), and 


350Q (OE8H). .See.the,above example for port number 


configuration. 
Options. wpe through. hh will “not prompt for input... The 
TRUE/FALSE values will’ be toggled ‘to the alternate value when 
the option is selected.,....., 


~ Pad - . ° -_- 8 > eo ~~ om e ry ow e 
o _ B - . 
-— - ~~ . - } te 8 


Options "I" through "K" prompt for the number of "nulls" 
required after a carriage return (shown on the menu as "CR") is 


sent to the device. The values_ 0 through i are. valid for this 
~ prompt. : . ea 


- 


Option "L" allows the user to decide whether or not a character 
erased by using the Delete key is echoed back to the terminal or 


ooo -if- it is removed from the video screen by backspacing over it. 


Normally this value should be TRUE for hardcopy (printing) and 


FALSE for video display (CRT) terminals. The TRUE/FALSE value 


will be toggled when this option is selected. This option's 
value automatically becomes TRUE each time MOVCPMnn and SYS--EN 
are run. 


Options "M" and "N" allow the user to determine the nature of 
the Printer Ready Signal-and which pin of the RS-232C line 
connector is to be used for that signal. When these options are 
selected, the alternate value is toggled in automatically by the 


program. a e 


gin” 2 


ee ee 0 


saosdieiieinatmaiit “unniatine asain siti ~ dea Rieien taiee, ad Yo one ps — arene ape Senay engi vr enrgerey pees gre ERE Tage -Caseer Renee qr ren gt eT EEEATEL: OULERYU GRIST erate, SIpTgTe aEwee Ae a pom RA RNY ON 


or we) Seem ewe wee + 


2 cape wee 
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ee Section Five: Disk Parameters Sub-Menu - 


— 


The Disk Parameters Sub- Menu, “allows the. options of enap ind (or 
disabling) the detailed, disk error messages after.a hard (non- 
recoverable) error, Risa. the user may select for either hard- 
sectored or soft- sectored 5.25-inch. disks. (provided that the 
user has‘“the. appropriate: controller. to back the selection). An 
option L's also available for setting. the step rates of the 
associated “5. 25- inch ‘disks. ‘The. step, rate. is the. length of time 


used by the drive*to position thé réad/write head from one track 
to the next moving either a TEER 


t a -_ - « ~ ~ 
. - < ; © ee ee eg ges i i ar 
i ea te ia - c fo vewh ae a 
y aod 


The 5.525- ine ch, ‘hard- sectored, ‘“Grives: (those. utilizing. the HIT 
controller). used" in ‘Heath/ Zenith: “€quipment. are, designed. to-.. 
operate | “at. aS 30 ‘mS “step. rate... These drives. may be set at... 
multiples of 2 mS’ interval. between 6-and 30-mS,. -It is’. 
recommended “that the step rate. be set at. 30 mS for most work, 
See "Step- Rate Error Checking", “below, before changing the 


Po ~ 


step rates, 


Tne 5.25-inch, soft-sectored, aries hones utilizing the H37 
controller) are recommended to operate at 6 mS for 96 tpi 
(tracks/inch) density and at 30 mS for 48 tpi. These drives may . 
be set at 30, 20, 12, or 6 mS step rates. More information is rN 
contained in the wanwed that accompanied the drives. See "Step- Care : 
Rate Error Checking", below, before changing the step rates. | 
NOTE: The. step rates. for 8-ineh disk drives or the 
Winchester Disk System are not adjustable. 


Step-Rate Error Checking: oy ee ee 


~ ““" “Occasionally, some performance improvement may be obtained by 
decreasing the step rate of the drives ( 1.e€., decreasing the 
track-to-track travel time) without increasing the error rate. 
Caution should be used in selecting the step rate for other than 
the recommended rate. If the step rate is adjusted too low, the 
System may not operate at all, or may require numerous attempts 
to read from or write to the disks, If an error is encountered 
in reading a sector, CP/M tries to read it again and again until 
it either reads the sector correctly (which is considered a 
"soft error") or reports an error when ten unsuccessful attempts 
to read have been made (which is called a “hard error"), CP/M 
keeps track of the number of soft errors that occur. (See 
Appendix D on page 127 for explanation of disk error messages.) 


, fo check the current disk error rate, use DDT (Digital 

Research's Dynamic Debugging Tool) to examine the value of 

"SECNTnn"™ (see: Chapter Eight for the location of this value) in 

- the BIOS tables. Do this after the System has been running for a 
while because SECNT is set to zero oo) at each cold boot. 
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- 


SECNT represents the number of soft (recoverable) errors that 
have occurred in read/write operations with the disk. This value 
needs to be maintained at arelatively low level, and should not 
increase unreasonably in the period of one hour. If the value 
becomes too large, the step rate interval should be increased so 
that the read/write head is allowed additional time to reach the | 
required track. 3 


‘The disk parameter options which appear on your terminal may be 
different than shown in the example below: | 


A 
B 
C 


Nt oO 


5.25 
5.25 
5.25 


5.25 
aed 
5.25 


Inch 
Inch 
Inch 


Inch 


Inch 
Inch 


Soft 
Soft 
Soft 


Hard 
Hard 
Hard 


Sectored 
Sectored 
Sectored 


Sectored 
Sectored 
Sectored 


Unit 
Unit 
Unit 


Unit 
Unit 
Unit 


0 
1 
2 


#®undefined** 
#®undefined#® * 
*®undefined#*#* 


Step 
Step 


2 Step 


Rate: 30 
Rate: 30 
Rate: 30 


ms 
ms 
ms 


G Detailed Disk Error Message: FALSE | | 


main menu 
main menu 


Finished,make changes and return to 
Quit, make no changes and return to 


NK 


Selection: 


a Options. "A" through -"C". will--prompt.for the step rates for soft-—- ee 
sectored disk drives and for either 48 or 96 tpi (tracks per 
inch). Valid step rates are 30, 20, 12, and 6 mS. If during 

the initial hardware exploration some of these disks are not 
found, the corresponding unit will be displayed as 
"e#undefined#F" , 


Options "D" through "F" will prompt for the step rates for hard= _ 
sectored disk drives. Valid rates are from 6 to 30 mS in. 
increments of 2 mS. If these units are not found, the value 
will display as "#®*undefined#®*#", ~ : 


Option "G"® does not prompt for a value. When selected, it will 
automatically toggle the value to its opposite. If TRUE is 
shown prior to selection, FALSE will be substituted when that 
selection is made, For a complete listing of the detailed error 
messages, see Appendix D on page i2e7. 
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ret oe a Se eee 


Section six: Default I/0 Configuration Sub-—HMenu 


The standard BIOS will also Support the CP/M IOBYTE for logical 
to. physical device mapping, as described in the CP/M alteration 


guide. In the standard configuration, the devices Supported 
ares: ik —— Lf 


on ew - > “ - ~ $ 


OP ees CRT: The ices Terminal. 


_—_ _ 
—_ = iad . = Rs Ne 


- 2+, J7TY: . An ASCII “terminal. without handshaking. 


BAT: : A-- batch pseudo-device that uses the reader (RDR:) 
> Logical device for eee and the list (LST:) logical 
Y : device. for. output, 

UCi: - A. pseudo-device that uses the console logical device 
; -for -input, and the list logical device device for 
, Output. 


LPT: A Heath WH-14 or WH-24 (TI810). A printer with 
hardware handshaking. | 2 


x 


UL1: A Heath WH-44 (Diablo 1640 or Diablo 630) used as a 
lineprinter with ETX/ACK protocol, 


PTR: Null source, not implemented. Returns an End-of-File | 
__when accessed, a ae a 


UR1: Configured for MODEM input. 

UR2: Same as CRT: 7 
PIP: Null wie. not implemented. 
UP1: Configured for MODEM output. 


UPe: Same as CRT: 


The default IOBYTE sets the logical device assignments at cold 
boot time. This is used to control such things as where the 
console is and what type of line printer is in general use. 


The I/O Configuration menu will appear on the console as: 


CON: = CRT: Available TTY: CRT: BAT: UCi: 
RDR: = UR1: Available TTY: PER: URi: UR2: 
PUN: = UP1: Available TTY: PTP: UPi: UP2: 
LST: = LPT: Available TTY: CRT: LPT: UL1: 


Finished, make changes and return to main menu 
Quit, make no changes anc return to main menu 


a Va WwW > 


Selection: 
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The menu-shows the current logical to physical device. mappings. 
Immediately to the right of the current settings are lists of 
"options that are available for selection. 


ned ~ wa . 


;Options- "A". through "Dt will prompt you to input one of the 
:available physical device designators. After selecting A, B, C, 
or D, from this sub-menu, the monitor will display the 
appropriate -prompt. For example, if D is selected, the program 
would display: 

“LST s. = & 
When the three letters of the physical device are input in 
response tothe logical device prompt (LST: being the logical 
device), 
LST: = TTY. 
the program returns automatically to the sub-menu and displays 
the new value.of the logical device that was selected for 
alteration. - 


NOTE: The. colon, “":", is not necessary as input to 
this prompt, nor is a carriage return. 


ween eer ew em ee ee cree nme meee eee ee mm ee ce ee ee ne 8 ee ce a mee ee ee ee ee ere erm ner carat ree meee oe ree ee = A RR A LL 9 Ne 
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section Seven: Automatic Program Control Sub-Menu 


The automatic program control menu allows you to specify the 
execution of a command or program immediately after either a 
For this option to function 
properly, it is necessary that you insert the command or program 


cold or warm boot or both. 


name in the automatic command line, 


option "C" on the sub-menu, 


This is done by choosing 


For example the program control sub-menu might appear as: 


A Run automatic command line on Cold Boost:. True 
B Run automatic command line on Warm Boot: False 
C Automatic command line: CONFIGUR 

Y Finished,make changes and return to main menu. 
Z Quit, make no changes and return to main menu. 


Selection: 


The "A" and "Bt options will toggle the TRUE/FALSE value for the 
automatic program execution on cold and warm boot, The "Cc" 


redisplayed menu, 


oo ————"PTalis option can be used to “automatically load BASIC or. some 


other program each time the computer is booted, As an example, 
the following is how you would configure a disk to automatically 
run the BASIC program "Adventure" each time the cee was weer: 


dee Prom 4 ine. main menu type: D to get to ine ore Seoeees 


Control Sub-Menu. ( 


The menu will be displayed as is shown above, 


2--In response to the program's 
Shown here: 


Selection:C€ 


prompt, 


"Selection:", type C. 


“Automatic Command Line:" will then be displayed. 


3-~In response to this prompt, type BASIC ADVERTURE: 


Automatic Command Line: BASIC ADVENTURE 


Yo--Press RETURB. 


"BASIC ADVENTURE" will now appear in the menu and the program 


Will wait for another selection, 


Yiw 


Selection will ask for a command line to be input by the user, Fi ° 
and then it will enter that automatic command line in the See 


ww ce mewe - 


re -- ee comms - eng campos ee. 


Page 107 


‘The Configuration Utility Automatic Program Control Sub-Menu 
oo 
we 5--This time, type Y. ° 


ee 


The program will incorporate the two changes and redisplay the 
main menu. 


6—~-To exit the main menu, type Y. 


This will make the changes to memory and will also write them to 
the disk, then returning you to the CP/M command mode, 


From now on, each time that a cold boot is performed on this 
disk the automatic program feature will load BASIC, then load 
"ADVENTURE.BAS", and then execute the program, | 


we we yp weer ene: ay oe 


NOTE: Both BASIC and ADVENTURE.BAS must be present . 3 
on the disk or an error mesSage will be displayed. 


The disk could also be made to load "BASIC ADVENTURE" whenever a ' 
warm boot is performed, ; 


®e 
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° The Heath/Zenith BIOS Loader (BLDR). 
8 Basic Addresses within the Heath/Zenith BIOS. 
eS BIOS Options Listing 
© The Algorithm for Disk Deblocking. 
® Disk Formats. 
e Page Zero and Clock Organization, 
The Heath/Zenith implementation of CP/M includes several 
features to enhance the flexibility of the standard CP/M system. 
As new hardware devices are introduced, they will be supported 
qm under this operating system. As a result, the BIOS (Basic Input aan 
- Output System) is larger than the amount of space provided for ay 


that purpose by Digital Research. 


—____._ Therefore, Heath/Zenith has designed a program-to-fit-where-the-———————1 
BIOS is normally recorded on the system tracks. This program is 
capable of using the CP/M file system to open a disk file and 
read in the complete BIOS. It is referred to as the BIOS 
Loader, and contains just enough intelligence to read from. the_ 


"disk and do some simple terminal I/O in case of anerror. 


When the system is cold booted, the monitor ROM reads the first 
sectors of the disk in the selected drive into memory and then 
control is transferred to that program, The cold start loader 
contained in the first half of those sectors reads the contents 
of the first tracks into memory at the appropriate locations for 
the configured memory size, When that is complete, control is 
passed to the cold boot entry point of the newly loaded system. 
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_ BIOS System. Organization ~~ 7T™ ~~~ - The BIOS Loader 
Ce Section One: The Heath/Zenith BIOS Loader | 


he, 


With the Heath/Zenith CP/M, instead of being the standard BI95 
that is loaded initially, the BIOS loader (BLDR) is loaded and 
executed. This BLDR opens the file named BIOS.SYS and reads it 
intoe the appropriate -locations in memory. 


By wsingt:the BLDR -concept,--the Heath/Zenith implementation 
overcomes the size imitetion imposed by the Digital Research 
design andia@t the: same time simplifies the otherwise error-prone 
process of integrating one's own modified BIOS into the system. 
The tpenalties:. paid -are -skight--the disk from which you cold boot 
must contain the BIOS.SYS file, and it takes somewhat longer to 
cold boodt:because the BIOS file must be opened, read and 
relocated in memory. 
c Sefge Zervc |2rf flaw. Lr er: 
Note that the BIOS.SYS file ie only weterencee during the col 
boot process, so it only needs to be on the disk used to cold ‘ 
boot your system. The warm boot function of CP/M does not re- 
read the BIOS, and therefore this file does not necessarily have 
“-to appear on disks that are used. Suiaas a warm boot, 


- .The BIOS, SYS file “eonbeins fhe BIOS in a relocatable file format 
that is compatible with the page relocatable format used in 
Digital Research's MP/M operating system. This relocatable 
format is reasonably compact, and storing the BIOS in 
relocatable form provides the advantage of not requiring 
a relocation of. the. BIOS. during MOVCPMnn., — 8 i i er eo 


Xe 
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*Section Two: Basic. “Addresses. “in-the “BIOS: . 


fe 


The Heath/Zenith BIOS: implementation. is “structured so that 
system: utilities can readily access its device tables. (This is 
primarily a requirement of CONFIGUR, which alters some of the 


~-. - ~ % 


values which are used at run- time, — Many of these values would 


‘* Ps - 
fot = 
er _ 


- 
o~ = -_ = = - ~ -- . —_ ~~! - -: ad 


RY Dser™ phegren can: find ‘the BIOS by using | the address. at 
Focation 0001H asa” pointer (the operand. ‘of the jmp. wboot 
instruction). ‘That value will be or greater. than the. address of 
the start -of- the: BIOS. a : 


- ~_- we . a - m~ . PF como 
-@retog = ree et we Ff %. id . <= a"? : steen.} = _ 
Bae i ee < es ery ak oe ~ ~~ ~—- & ow . -— ae 7” 


- - = a ° . 


o = ef 6 


ere eo eane a dain pi Cable, This table include jump instructions 
ao oo Of Ae at. entry points. into. the. BIOS.. 


Pe - o- - - - w - bd 
~ 


~ 


=- - - - - 


The "“Viststt entry point for cheomine the’ output status ‘of the 
fist device is implemented in this release. This entry point is 
used by some background | printing spoolers,— | . | 


imeaeely following the standard entries is a one byte BIOS 
version number (in binary). It is important that programs which 
alter values in the BIOS in a direct way know exactly which 
version they are dealing with. For example, CONFIGUR must patch 
tables at the beginning of the BIOS and therefore needs to be 
reasonably certain that those tables are where it expects to 
a fin d--t hem. —----- ——-— nr oe Se 


Upon cold boot, CP/M will print the version number as part of 
the sign-on in a message like: 
32K Heath/Zenith CP/M 2.2.03 
where "03" is the version number. 


The next byte is used as a mode byte for the BIOS. At the 
moment six of the bits are assigned: the remainder are reserved, 
Bit 7 causes the CCP to attempt to execute the automatic command 
line on the default disk every time the disk is cold booted. 
Bit 6 performs the same function for each warm boot. Bit 3 
contains the Printer Ready flag, Osftlow and ishigh. Bit 2 
Supports the partitioning of the 267 Winchester Disk. Bit 1 
enables the printing of disk error messages by the BIOS so the 
user will receive extended, error-status messages. Bit 0 is set 
when the BIOS is configured for use with a H8-5 serial card for 
the console port. 


a ) 


The next series of bytes are used as serial device control 
Structures. These specify the port number, baud rate, number of Ce 
= nulls required after a carriage return, and upper case mapping 

flag for each Of the serial I/0 devices, The data is erranged 
as port number, followed by the baud rate divisor word, 
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The high order-nibble of the baud rate divisor forces a@11 output 
-to upper case if the MSB is 1, and the least significant 3 bits 
“of that nibble are the umber ‘of nulls sent after a carriage 
“réturn: to that device.--There is one of these structures: for 
“each of 5. devices (although only 4 are currently used)... In 
order, | “these are: “CRT, oe ee ees and Reserved. 


~~ & ~- - eo ae we cd : t- e -— ~ = ~ oe oa eee 
- - a = 
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Then two words (four pyead) are used as a soft. error ounver for 
“the 5.25- inch disk drives.: These- words are incremented after 
each soft (recoverable) error. pee ee ‘DDT t’o” examine: this 


Co 


‘e 


> 


ee ee ee. 


" 


“The “next: byte is’ ‘set for the- maximum: number of disks that:-this 


- Fe es wt 8 


BIOS _ may. Oe configured for. ‘This Allows - “programs -to- determine 


Mr Aw. Fe eee ae 


~that really ente ks 3 
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“This ‘is followed 7 the disk: parameter base and the disk 
“parameter entries for each of the disk drives. In addition to 
the 16 bytes per disk assigned by Digital Research, the 
“Heath/zenith a a ea has added . bytes i each entry. 


iq, “The first of these 8 is a multi- -purpose byte that is used to | 

Ue identify the drive type and its port address. The three most : 
significant bits indicate the drive type. The second byte is the 

select code necessary for this drive. The next byte is the 
number of 128 byte records per physical sector. It is followed 
by a byte indicating the number of 128 byte records per 
allocation unit. The next four bytes are used for all drive 
controllers Exe Dt the A/247, 


For the 5.25-inch disk drives the first of these indicates the 
current track position of the head for this drive. fhe next 
byte controls the step rate. When set, the most significant bit 
of that byte indicates that the drive wild be up to speed in 250 
mS instead of the normal 1000 mS. The next byte contains flags. 
The last byte is reserved for use during the physical to logical 


drive mapping process. | | 


' For the Z67, these bytes are used a bit differently. The first 
word (two bytes) is the logical sector number of track 0 in a 
partition. The last word is the logical sector number used in 
upper boundelimit checks, 


~-- Jn addition to these tables, it is necessary for some system 
slg utilities to have access to some of the values used for disk 
iia control. These values have been located in BIOS and in page 0 

- of memory. These values control the motor and select time-outs 
oe as well as the head settle and write-gate step delays. | 
| 


At OOODH the current value of the H/Z89 control latch at port 
362Q is stored. Tnis port controls the presence of RAM at zero 

and enables/resets the clock. In the H8, the clock enable and 
RAM at zero are split between two different ports. 
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:. The’ ‘H/Z89 contains special Nardvane ee, Gane incur and output 
“instructions to some of, the H8 control. ports: and generates a 
*" nonmaskable. interrupt (NMI).. Since-the-Z80 NMI vector falls 
“within. the RAM allocated for the default-file control block 
“ (FCB), it is not possible to- guard it with a return instruction 
or to install a jump to a user routine. Therefore, care must be 
_baken that. no inputs-or outputs: to: the HB: control: ‘ports (360Q, 
3640, 372Q,. 373Q) are. attempted.in-the: H/Z89.--Location O0OEH ‘is 
used. for the. Value required to reset: the: -6Tock on the’ H8, or 0 
if. on. an. H/Z89. . Location. OOOFH is-reserved:for:the contents of 
the H17/H77/Z87 control port. The 16 bytes located at OOH0- 
DO4FH are reserved, | 
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An’ effort will. be made to-~ “keep - -these- values. in their~ same 
,hélative. positions, . However, -1t. is quite: possible that between 

‘this _ ‘release and future releases of CP/M from Heath/Zenith there 
Will’ need to be some redefinition of the BIOS structure. There ‘ 
-.1s a diminishing probability. of -change: with each release 

thereafter. Software that accesses these tables should be 

“written using. an- easily redefinable template to simplify 
adaptation to such changes. : : 
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t 
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BIOS Options: : 
‘Cue 
When CP/M is cold booted, the system generates the message: See 


Se ee a eres ete 
fae a 32K -Heath/Zenith CP/M 2. 220 ! 
4 FOR{type} DISKS WITH OPTION(S){code} | : 


active within the BIOS. 


The list of options are as follows: a, ~ 
P The Z67 is Partitioned 
- P2 BIOS supports two Z67 Partitions 
I CRT Input is Interrupt Driven 


B CRT "BREAK" key'ts Interrupt is available 
(causes an immediate warm boot) 


E3 BIOS supports Extended Double Density on 
_ 237 Disk Drive . 


EY BIOS supports Extended Double Density on 
H/Z47 Disk Drive 


- Ts Time of Day Clock | C. 2. 


The "code" will show the options that are currently. selected 
E Event Counter 
| 


__the disk is removed or changed, or a cold or. 
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Section Three: Disk Deblocking 


The Heath/Zenith BIOS uses a deblocking algorithm which 
transparently converts the sectors stored on the 5.25-inch, the 
8-inch disks, and on the Winchester Disk to the 128 byte logical 
records used by CP/M. The BIOS uses information provided by the 
BDOS to minimize the number of physical read and_ write 
operations. 


When accessing the disk, the deblocker keeps track of the 
logical records that are currently buffered within the BIOS. If 
the BIOS is processing a read call, it is possible for it to 
retrieve the information from its buffers without any disk 
activity if the proper sector is already in memory as a by- 
product of a previous operation. 

Tne buffering that occurs during the write operation means that 
records can be buffered in memory until the next disk operation. 
The buffer is only written to the disk if the calling program 
accesses a logical record that is not contained in the current 
physical sector, the buffer overflows, or the write is flagged 


as a “directory access." 


One important ramification of this "write-behind" is that 
programs that do direct BIOS calls to perform track/sector disk 
I/O should make certain that the write buffer is emptied before 


performed, This can be done by specifying that the last write 
operation should be performed immediately without "write-behind® 
as the BDOS does when it accesses the disk directory. See the 
CP/M 2.0 Alteration Guide, pages 34 and 35. 


warm boot is 
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Section Four: Disk Format | ib 


§.25—-Inch Hard-—-Sector Disk Forgat 


The logical records are numbered from. 1 to 20 on each track, and 
are stored in physical sectors 0 thru 9. The tracks of the disk 
are numbered 0 to 39. The CP/M system reserves the first three 
tracks for the Cold Start Loader, the CCP, the BDOS, and the 
BIOS Loader. The CP/M directory begins on track 3, and _ the 
usable space begins immediately following it. 


8-Inch and 5.25-Inch Soft-Sector Disk Formats 


The Heath/Zenith implementation of the BIOS transparently 
Supports a mixture of single, double, and extended double 
density disks. In addition, each of the densities can be 
recorded on either single or double-sided media. Tne first time : 
a disk is “logged-on" after a disk reset function (such as a 
warm boot), the density and whether the disk is double or single 
Sided is checked and used to dynamically modify the disk 
parameter tables for the particular drive. The most important 
ramification of this is that disks of different densities or 
number of recordable sides should be “logged-on" after being 
interchanged, 7 


| . 
The Heath/Zenith configuration offers the user three densities 
ow available on the 88-inch disk. -.Single density.-is comprised of -26--—- --—-- 


sectors per track with 128 bytes per sector. Double density 
contains 26 sectors per track with 256 bytes p>. sector, 
Extended density uses 8 sectors per track with 1024 bytes per . 
sector. Deblocking is used on double and extended densities to ss. 


_Make each track appear to have 52 and 64 sectors respectively. 


The 5.25-inch soft-sectored disks have two possible densities. 
Single density offers 10 sectors per track with 256 bytes per 
sector. Double density has 16 sectors of 256 bytes each per 
track. 3 


te 


section Five: Page 


(also see 


‘BIOS System Organization 


Page 115 


Page O/Clock Organization 


0 and Clock Organization 


OO00H jmp  BI0S+3 
000 3H db IOBYTE 
OO0O4H db DEFAULT$DISK |. 
O005H jmp BDOS+6 
0008H jmp clock 
| dw TICCNT 
OOODH db HBSCTL 
am OOOEH db HS8CTL 
OOOFH db DEVCTL 
~~" 90OT8SH ”””©6jmmp)ti‘<iaRSTINTO 
0020H jmp  H37INT 
0023H . dlymo37 ~~ db 0 
" 0024H dlyn37 db 0 
0025H h37ctl db 0 
- 0026 nh37iret dw 0 


"CP/M 2.0 Alteration Guide" pages 23-24) 


swboot entry use value 

* at O0O0O1H as a pointer 

* to the BIOS to access 

* jump vectors and tables 

scurrent IOBYTE 

scurrent default disk 

sBDOS entry point use value 
at O006H to find the top 
of user memory (subtract 
CCP size if it is to be 
preserved) 

clock interrupt service 
vector 

1 work counter incremented 
every 2mS interrupts are 
enabled and clock is on 

current conterts of H88/Z89 
control latch (362Q) 

current contents of H8 
control latch (360Q), or 
zero if on H/Z89 | 

current contents of H17/H77 
Z87 control latch (177Q) 


@2e 2@2©@ @2¢ @20 @8© 20 26 26 260 280 20 


e2e'we 28 we 26 @8 


“3CRT input interrupt service 


vector 
‘“H37 interrupt service vector 
°H37 motor turn-off delay 


“counter ~ 

°H37 deselect delay counter 
°H37 control register image 
ewhere to go after H37 

* interrupt 


| 
seusing the value at location O0O0O9H as a pointer to the clock routine, 
sthe disk (H17/H77/Z87) timers can be accessed, they occupy the three 
sbytes immediately preceeding the clock interrupt 


dlymo: 
dlyh: 


ae dlyw: 


clock: 


db 0 
db- 0 
db 0 
ei 


ret 


emotor timer decremented 

s every 572 mS until 0 

shead load timer decremented 
* every 512 mS until 0 

shead settle timer 

* decremented every 4 mS 

* until oO 

‘clock interrupt service 

* routine, located in BIOS 


Se ERTS vee ‘we - 


ere “EEE -eme ee 2 
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2 Appendix A: Heath/Zenith CP/M 2.2 
fmm a re on a One Drive Systen _ 


For a large percentage of computer work, at least two disk 
drives are necessary. It is often convenient, for example, to 
nave the input files to a program on one disk and the output on 
another. The system files or the utilities also may be 
segregated from the program disks. 


While not as convenient as actually having more physical drives, 
the Heath/Zenith BIOS implementation does permit the one or two 
drive owner some of the advantages of having three separate 
drives. Regardless of now many physical drives are connected to 
the system, the BIOS creates three "logical" disk drives. If 
you have three physical drives, the mapping is the obvious, ; 
direct one. For one and two drive systems, all nonexistent 
physical drives are mapped onto an existent drive which is the 
drive in the front panel of the H/Z89, or the left hand drive of 
an H/Z17 on an H8& system. 


Whenever a nonexistent 5.25-inch drive is referenced, the system 
will first check to see which disk is currently occupying the 
mapping unit. If it is the appropriate logical disk, the 
Operation can proceed. If it is not the correct disk for this 
Operation, you will be prompted to put the correct disk in the 
drive, and to press RETURN, before the disk is accessed, For 


ae | 

Example, to TYPE a file named SAMPLE.DOC that resides on ee 

imaginary drive B, the procedure would be: 4 | 

sjuvicticwa ote APTLY PE. Be SAMPLE DOC <2-. ne i 

Put disk B in drive A: and press RETURN ! 

: | 

__STYPEing of SAMPLE.DOC ...> ee : | 

; A> _ : 
Note that the default disk is A, and that disk Bis mounted in 
drive B:. Any Subsequent operation at this point such as a warm 
boot, or a simple DIR with no arguments, will cause CP/M to 

request that disk A be placed back into drive B:,. 


By keeping track of each of the disks that you are using by 
mentally assigning them to what would normally be a physical 
drive, you can access “three" separate drives. 


There are only two exceptions to this mapping scheme: DUP and 

FORMAT. Because of the way that these programs must interact 

with the hardware, they do not support the logical to hphyswead 
_.._ 5. Mapping. 
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The FORMAT utility can only be used to format a disk on a drive 
ao that actually exists. You have at least one drive, namely drive : 
| A in your system. When you run the FORMAT utility, answer the ! 
prompt | 


oe j 


~~ o- 


Which drive do you wish to use for this operation? (A thru F): 


with man, 


le = 


~ 


The-DUP utility can only copy or verify disks that are mounted 7 
in physically separate drives. If you wish to perform an exact 
duplication of a disk, including the system, on a one drive 
System, “proceed as follows: | 


Pe a 
‘Tes ee 


<7: «Invoke SYSGEN 


<2" < SYSGEN VER 2.2.nn 

a “SOURCE DRIVE NAME (OR RETURN) 
ont | 
hea tckd with A for the source drive. SYSGEN will proceed to a 
read into memory the system tracks from the disk in drive A. 
een will then prompt with, - 


DESTINATION DRIVE NAME (OR RETURN TO REBOOT). 7 | 


a At this point, remove the disk that is in A, and replace it with 

ur the disk that you are creating. Answer the prompt with drive 

(. Be. You have now duplicated the system tracks on your new 
disks. 


~~ ——----To--complete the full duplication of your” disk, yow will need to 
. run the PIP utility. Mount your original source disk in drive A 
and type, ' 3 


TN (5k ORL rs |. ee ne ee ey eee ee ee 


(The 'R' option on the command line will insure that files that ~- 
are marked with the 'SYS' attribute are also copied). PIP will 
read into its internal buffers as much of a given file as it 
can. When its buffers are full, it will attempt to write them 

to the destination file, which in the above case, resides on 
drive B. CP/M, knowing that there is no physical drive B, will 
ask you to, | 


Put disk Bin drive A: and press RETURN. 


When PIP is through writing to B, it will then attempt to read 
from disk A. CP/M will detect that the wrong disk is mounted in 
..drive A: and respond with, 


te 


Put disk A in drive A: and press RETURN. 


This "swapping" of disks will continue until all of the files 
have been copied. Although the process is tedious, it does 
perform the desired function, 
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a ge ‘Appendix By _ Heath/Zenith Hardware Configuration 


‘The e H/289 Computer: 


a ee LEe = 
ane : - ar fra ‘ - fe P. ee cere . ‘ 7 
ae he ss = i a eS ig . 


The minimum Sueportapis system that will run under this 
+> implementation of CP/M is: 


®.An H/Z89 computer system with at least 32K of random access 
- read/write: sl © H-OF.¥. the. ae 7 or H88- i ROM modification kit 


-_-_ = re ed 


ra 
2. -— ee 
“fe 


@ bie obnvceted! fsaeiiener « disk drive (the H/Z89 comes with a 
single, drave-with a H/Z17 controller). 
This; sisrpkementation of CP/M for the H/Z89 will support the 
following:pieces of. hardware: 
SS eS ee eS ae oS mom esr, 


ater id oR Sf, (ee 
The Computer: | 
a An “H/Z89. enue systen. with “32K or more (654K max) of pandon 
ae -- aecess read/write. memory, the Z89-7 or H88-7 ROM modification 
~kit must be installed (already done on Z89-FA and later 
models). -7> ttt ototlst ot as 


-~ - ~ ~- 


: Disk Drives: Tiree et, Je ge te my ee 


~ 


0 oe see ee, egere g we es ao aes woes wa tee. we ws 
— tad < 


-@ From one to three hard=sectored 5.25-inch floppy disk drives fo dren 
(H/2Z17 controller). eg 


ee .. & From. —_one__to_-three._soft-sectored—5.25-inch--floppy- -disk drives ———--——-—-—- 
(237 controller). 


Oe ee a tea eee ore 


% Two 8-inech floppy disk drives (H/Z47 controller). 


Fe 


-@ One Winchester Disk ‘System (10 MB Winchester Disk and Single 
8-inch Floppy Disk; Z67 controller). | — 
With a maximum of six drives connected and functional. (Note 
that only two types of drives may be connected at any given 
time.) 


te 
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a PRPAN CEOS cos wats 

(.- @ A diablo 630, 1610, 1620, 1640, or 1650 (compatible) | printer 
‘set to 1200 baud, and an RS-232C cable connected to the socket 
labeled DCE 340-347. Tne UL1: logical device driver should 
be connected to this port. Tt uses an ETX/ACK handshake 
protocol to control the printer output. 


e An H14, WH14, WH24 or H/Z25 dot-matrix printer, utilizing the 
RT-S modem control for. handshaking, connected to the socket 
labeled DCE 340-347. If your printer requires.any other 
swmandshaking convention (beside those possibilities that may be 
covered by the Configur utility, on page 99), it will be your 
responsibility to appropriately modify the BIOS physical ) 
device driver.. The Heath/Zenith Software Group can not assume 
the responsibility for any such modifications, 


6A WH36, or any printer that does not require “busy" 
handshaking, may be connected to the TTY: logical device, 
again it is plugged into the socket labeled DCE 340-347. In > ? 
the Configuration program, specify the port number for the 
TTY: as being 340Q and move the LST: device to 320Q, (H/Z89 


computers are not currently supplied with port 3290Q 
populated, it is made up of the empty set of sockets on the 
serial interface card.) 


© A WH13 modem connected to the plug labeled DTE 330-337. 


em en ae ce a ee ce rm RR RR EY SS 
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The Heath H8 Computer 


The minimum Supportable system that will run under this 
implementation of CP/M is: “s 


@ An H8 computer system with at least 32K of random access 
read/write memory (the HA-8-8 Extended Configuration kit must 
be installed). 


© A terminal connected to the computer with a serial interface 
at port 350Q (OE8H) on an H8—-4 card or port 372Q (OFAH) on an 
H8-5 card. 


@ One connected, functional floppy disk drive. 


This implementation of CP/M for the H8 will support the 
following pieces of hardware: 


© An H8 computer system with 32K or more (64K max) of random 
access read/write memory (the HA-8-8 Extended Configuration : 
kit must be installed). 


oA terminal connected to the computer with a serial interface 
at port 350Q (OE8H) on an H8-4 card or port 372Q (OFAH) on an 


@ From one to three hard-sectored 5.25-inch floppy disk drives REY | 
(H17 controller). ey 


__@ Two 8-inceh floppy_disk drives (H/Z47. controller) ©... WW ~..----——..---—-- 


Ot RD CTD te 80 PGT ee oe 


With a maximum of six drives connected and functional. (Note 
that only two von of drives may be connected at any given 
time. a 


SO OT OLS CLI TIE LOOT Oe — me 
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Printers: 

2A “Diab 15630721640. 1620, 1640, or 1650 (compatible) printer 

. set to 1200 baud, and the RS-232 cable connected to port 340- 

- 347 on an HB-4 ‘card, The UL1: logical device driver should be 

-“eonnected to this port. It uses ETX/ACK handshake protocol to 
control -printer bk det 


~- - e - 
“ 25 - « o oo ee Se a —- we ~~ « 2 
4 2 s = ne pas 


@ An HT, WHI, WH24 or i228 ‘dot- -matrix rae utilizing the 
“RTS modem control for handshaking, connected to port 340-347 
on an HB-A card.. 


- 
F a - - ~~ ae - - a” wo ~ - - — -- wf - - - 
ay large tiles ¥. w aa xo 7 ane ° _ :< 

- _ x = a» 7 . -_—- A 7 ie = if ~ - » * - 


nad -~ 
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If.c your. printer ae eee other handshaking convention 
(beside those possibilities that may be covered by the Configur 
ptility, on page 99), it, will be your responsibility to 
“appropriately modify: ‘the BIOS. ‘physical’ device driver. The 
Heath/Zenith Software Group can. not. assume the responsibility 
for. any. such “Modifications. — a: = 
oA WH36, or any printer that does not. require "busy" 
handshaking, can be connected to the TTY: logical device, s 
‘again it’is plugged into port 340-347 on an 8-4 card. In the 
‘Configuration: program, specify the number for the TITY: as 
being 340Q and move the LST: to 3209. 


© A WHT3. modem connected to port 330-337 on an H8-4 card. 
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. Appendix C:; SW-501 Switch Configuration: 
6S 23 2 2 o: : 7 . 
\ eeeeeosss fe eee ene eee J=Auto-Boot O=Not Auto-Boot 
OX seen en nnn nen Baud Rate | 
) eee Memory Test/Normal 
| Ko rere ene en enn 1=Primary (170Q) O=Secondary (1749) a 
+ > X X aaa wee Device Type (port 170Q) . 
X X ----- Device Type (port 174Q) 
ee WARNING: Boxed-in areas show 


hazardous voltage locations. 


SS ey Semmens — + rp reharemang maypones ss : eesrie 
¢ : . 


) ~ Mis cee 


nab: 
= REF, ' 
ath ae: 
Ae . 
isi : < 


( 


et 
ind 
pe Rocio. 
: Pe S L | D c 
a _ TOWARD FRONT 
“SEE ve 


Figure C-1 
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Figure C-2 
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When the Heath/Zenith BIOS encounters an error when it tries to 
read or write to a disk, it will retry the command. Each time a 
"soft" “Or récovérable error “occurs with a 5.25-inch disk, the 
appropriate  SECNTnn~ variable -focated in-the BIOS tables is 
incremented. In the event that.the sector_still can not be read 
or written, the error is flagged as "hard" or non-recoverable. 
The hard error causes the operating-system-to-generate an error 
message: Stating that a read,or write error has occurred. In 
addition to~that~message,-—the BIOS can be configured to provide 
an error messagé that tneludes an error code describing the type 
of error that occurred. Se — 

i C Ee 

These error codes. are all two- digit hexadecimat numbers that 
specify: the type of error-_that -has- oceurred;-- Each disk 
controller has its; own set of disk error codes. — The error code 


tables : for _-each= typeof device is found in that devicets 


hardware Manual Cexcept ‘for the H/217 ‘controller, and four of 
the 267 error Socees” “These codes—are-—listed below). 


3; ———- 


EN oe sme . 
Oe oe en oe wom eee Oe ea oat 


H/217 Error Status Codes: RE Se ge, dat eee 


01--Bad Track Error: —-most likely. an error in the floppy disk 


mechanism, often caused by™ SONELGUSI ne the BIOs drive step | 
time too short, : | Fae EE 


eon + 


rd : Ato sway 


Coe = | ta 
O2--Head Syne Error: an error has occurred in the format of the : 
__ floppy disk. , os ee fats ea eRe A TT 


ee ee nme 


O4}--Header CRC Error: oan error in reading the sector 
- identification header, generally caused by defective media. 
08--Data CRC Error: an error in reading the data on the sector, 
wv ~so~- Gan be caused by defective media, power failure or "glitch" 
during writing, defective hardware, 


10-~Record Not Found: the specified track and sector can not be 

. located, can be caused by poor alignment, imperfect media, 

or incorrect disk drive rotational speed, specifying a non- 
existent track or sector, 


20--Missing Data Syne: an error has occurred in the format of 
the floppy disk. 


HO--Write Protect Error: an attempt was made to write to a 
Write-protected disk. | 


80--Unit Not Ready: the drive unit was not ready to read or 
write data. This can be caused byt‘not having a disk in the 
drive or leaving the door open. 


Z67 Error Status Codes (not in Hardware Manual): 


80 through 82--Hardware interface crrors. 


83-~-Attempt made to exceed partition boundaries. 


ia ee eee eee Be nee ene ati eae een: einen, pe. pei et te eee eee ae TE | e 
; a 
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Appendix E: Disk Handling and Operation 
Disk Handling * 


& 


Disks are easily damaged. Handle them with care. Observe these 
precautionary practice: | 


© Keep the disk in its storage envelope whenever it is not in 
the Floppy Disk drive. 


8 Keep the disk away from magnetic fields. Magnetic Fields 


can distort the recorded data on the disk. 
) Replace damaged or worn storage envelopes. 
© Write on the plastic jacket only with a felt-tip pen. Do 
| not use a lead pencil or ball-point pen. 
@ Keep the disk away from hot or seneenvnaeunk material. 
e Do not expose the disk to sunlight. 
® Do not touch or clean the surface of the disk. Abrasions 


can alter stored data. 


Disk Loading 


Refer to Figure E=1, open the front panel door, and insert the 


disk, label facing the open door. Then close the door, 


FIGURE E-1 
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Hechanical Write—Protection é 


The disk can be write-protected so that it cannot be written on. 
(All distribution disks are sent write-protected.) Depending on 
the size of the disk, this is done differently. A 5.25-inch 
disk has a "write-protect" notch on the side. When the notch is 
covered with a tab or opaque tape, no data can be written on the 
disk. Figure E-}2 shows a write protected 5.25-inch disk, and 


Figure E~3 shows one write-enabled. 
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An 8-inch disk has a “"write-enable" notch on the side. If the 


we 


; tech is. exposed, . no data can be written on the disk. You must ; 
- “eover the notch to allow writing on the disk. Figure E-4 shows a 


7 write protected @8-ineh disk, and Figure E-5 shows it write 
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APPENDIX F: DRIVE NAME DETERMINATION 
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H/Z47 BOOT DEVICE 
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_ H/Z67 BOOT DEVICE 
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A>DIR 
fom” ASM 
a DUP 
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THIS? 


ASDIR 
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REFERENCE LIST 


COM : DUMP 
COM : MOVCPM47 
COM 


Is A REFERENCE 


ASM s MAKEBIOS 


REF LIST GF WHAT 


CCM 
COM 
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ASM 
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: CONFIGUR COM 
g FORMAT CCM 
e STAT CCIM 
: LIST 


COM 


OF CPM VOLUME II 


s DUMP CaM 
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LIST OF CP/M 2.2.42 VOLUME ITI 
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